Skip to content

Latest commit

 

History

History
127 lines (86 loc) · 4.77 KB

PaaS.md

File metadata and controls

127 lines (86 loc) · 4.77 KB

🐳 Your Personal PaaS

⭐️ GOAL: Deploy your first application on CapRover!

⏰ Agenda (120m)

🏆 Objectives

By the end of this class, you'll be able to…

  1. Demonstrate a working, self-hosted platform as a service application available on a custom domain.
  2. Use CapRover to deploy a web application written in Python and Flask.

[10m] ☀️ Warmup: Update CapRover Dashboard

  1. Log in to your CapRover server: https://captain.dev.YOURDOMAIN.COM
  2. Click the Update link at the top left, then click Logout.
  3. Wait 3 minutes and refresh the login page. When it appears, log in to your updated CapRover instance!

[10m] 📚 TT: Introduction to CapRover

Walk through the features on the CapRover website.

The image below walks through using CapRover to deploy:

[20m] 💻 Activity: Feature Frenzy

Break out into teams of 4, then write a short synopsis of the following links. In your own words:

  • Explain the feature
  • Describe it's options (if applicable)
  • Tell us how you'd use it.
  1. Persistent Apps
  2. CLI Commands
  3. One-Click Apps
  4. Deployment Methods
  5. Captain Definition File

Be prepared to give a 2-3 minute review of your topic to the class.

[15m] 💻 Activity: Feature Frenzy Presentations

[10m] 🌴 Break

[20m] 💻 Challenge: Deploy a Tarfile

GOAL: Practice the most approachable deployment mechanism --- upload a tarfile on CapRover, then deploy it.

  1. Visit caprover/captain-sample-apps.
  2. Choose a .tar file for a sample app, and download it. Recommended:
    • Python/Django
    • Go
    • Node
    • React
  3. Go to https://captain.dev.YOURDOMAIN.COM in your browser.
  4. From the left menu, select Apps and create a new app.
  5. Name it first-app.
  6. Go to "Deployment" tab and upload the tar file, then wait for the deployment to complete.
  7. The first time you build, it'll take a few minutes. After the build is completed, visit https://first-app.dev.YOURDOMAIN.COM.
  8. CONGRATS! Your app is live!! When complete, celebrate by posting the link to your working deployment on the #bew2-2-docker Slack channel!

[10m] 👍 Review: Deploy a Tarfile

Go over the activity and answer any questions.

[20m] 💻 Challenge: Deploy via CapRover CLI

GOAL: Practice an alternative, popular way to deploy: via CLI command.

If you get stuck, review the following guide to deploying on CapRover: Complete Webapp Tutorial

  1. Visit caprover/captain-sample-apps.

  2. Choose a .tar file for a sample app, and download it. Recommended:

    • Python/Django
    • Go
    • Node
    • React

  3. Unzip the content by double-clicking the .tar file you downloaded, then open a terminal and navigate to the unzipped directory.

  4. Run the deploy command below. Be sure to read carefully and follow the instructions once you execute it!

    caprover deploy

    Enter second-deploy when asked for the app name.

  5. The first time you build, it’ll take a few minutes. After the build is completed, visit second-deploy.dev.YOURDOMAIN.COM.

[10m] 👍 Review: Deploy via CapRover CLI

Go over the activity and answer any questions, then dismiss class.