Deploy a project

Deployments in Altostra work in two phases:

  1. First, you publish an image of your project.
  2. Then, you either create or update a deployment from that image.

When you create an image of a project, Altostra bundles the project together with the project's files and pushes the image to the Altostra image repository on your account. You can then deploy that image to an environment of your choice.

For more information about project images, read the Project Image reference guide.

Before you begin

To create project images you must first clone the project Git repository to your local development environment and login using the Altostra CLI.

Create a project image

To create a project image, use the push command:

  1. In your local development environment open a terminal and switch to your project directory.
  2. Run any build process if your project requires it.
  3. In the terminal, run:
$ alto push v1.0

"v1.0" is just a name we use in this example, you can use any string you want, such as "my-image" or "testing-123".

When you run the command, the CLI automatically creates an Altostra project for you if there isn't one; if there is, it pushes the image to that project.

Deploy using Altostra CLI

List the available images

To view the available images for a project, use the images command:

$ alto images
┌─────────┬────────────┬──────────────────────────┐
│ (index) │    Name    │      Last Modified       │
├─────────┼────────────┼──────────────────────────┤
│    0    │  'v0.9'    │ '4/29/2020, 2:18:27 PM'  │
│    1    │  'v1.0'    │ '5/24/2020, 9:48:47 PM'  │
└─────────┴────────────┴──────────────────────────┘

Create a new deployment

When you create a new deployment, you essentially create a new "stack" or "instance" of your project, which is then updated with newer versions of your projects.

To create a new deployment for the current project using the image v1.0 that we created, use the deploy command:

$ alto deploy prod:v1.0 --env Development

This command creates a new deployment named "prod", or updates if it already exists, from the project image by the name "v1.0" in the "Development" environment.

Update an existing deployment

When you update an existing deployment, you push changes that alter that deployment instead of creating more resources. Deployments are bound to environments when they are created, you must create another deployment in a different environment if you wish to relocate a deployment.

To update an existing deployment for the current project using the image v1.0, use the deploy, this time the --env switch not needed and is ignored:

$ alto deploy prod:v1.0

This updates the deployment named "prod" with the project image by the name "v1.0".

After deploying

If the deployment mode for your organization is set to manual, then you need to follow the URL returned by the Altostra CLI deploy command to finish the deployment, for more information read about deployment modes. However, if the deployment mode is set to automatic, then the deployment starts immediately and you don't need to perform any additional steps.

List deployments

To list the deployments for the current project, use the deployments command:

$ alto deployments
┌─────────┬────────┬─────────────────────────┬─────────────────┬─────────────────┬────────────┐
│ (index) │  Name  │         Updated         │   Environment   │      Image      │   Status   │
├─────────┼────────┼─────────────────────────┼─────────────────┼─────────────────┼────────────┤
│    0    │ 'dev1' │ '5/22/2020, 1:29:41 PM' │  'Development'  │ 'NOT_AVAILABLE' │  'Failed'  │
│    1    │ 'dev2' │ '5/24/2020, 9:48:50 PM' │  'Development'  │     'v1.2'      │ 'Deployed' │
│    2    │ 'prod' │ '6/12/2020, 2:22:52 PM' │  'Production'   │     'v1.1'      │ 'Deployed' │
└─────────┴────────┴─────────────────────────┴─────────────────┴─────────────────┴────────────┘

List deployment details

To list the details for a specific deployment, use the deployments command followed by the deployment name:

$ alto deployments prod

History of deployment prod:

┌─────────┬───────────────┬───────────────────────────┬───────────────────────────┬──────────────────┐
│ (index) │      User     │           Date            │           Image           │      Status      │
├─────────┼───────────────┼───────────────────────────┼───────────────────────────┼──────────────────┤
│    0    │    'Daniel'   │  '7/1/2020, 11:06:52 PM'  │          'v1.1'           │    'Deploying'   │
│    1    │   'Samantha'  │  '6/30/2020, 11:40:10 AM' │          'v1.0'           │    'Deployed'    │
│    2    │     'Jack'    │  '6/15/2020, 8:19:25 PM'  │         'v0.1.5'          │ 'RollbackFailed' │
│    3    │     'Jack'    │  '6/14/2020, 3:53:06 PM'  │         'v0.1.5'          │    'Deployed'    │
│    4    │   'Samantha'  │  '6/12/2020, 1:27:23 PM'  │          'v0.1'           │    'Deployed'    │
└─────────┴───────────────┴───────────────────────────┴───────────────────────────┴──────────────────┘

Deploy using the Web Console

To deploy a project from the Web Console you must already have at least one image available for that project. Please refer to the Create a project image section above. To begin, login to the Altostra Web Console.

Create a deployment

When you create a deployment, you essentially create a "stack" or "instance" of your project, which you can then update with newer versions of that project.

To create a new deployment:

  1. Head over to Projects in the top menu.
  2. Click the project that you wish to deploy.
  3. On the Deployments page, click Deploy.
  4. Select New Deployment.
  5. Enter a name for the deployment.
  6. Select the Image to use for the deployment.
  7. Select the Environment to which you wish to deploy.
  8. Click Deploy to begin the deployment.

Update an existing deployment

When you update an existing deployment, you push changes that alter that deployment instead of creating additional resources.

Deployments are bound to environments when they are created, therefore, you cannot change the environment for an existing deployment. If you wish to relocate a deployment, you must create another deployment in a different environment.

There are two main ways to update a deployment in the Web Console:

1. From a project page

  1. Head over to the Project page to which the deployment belongs.
  2. Click on Deploy in the Deployments page of a project.
  3. Select Existing Deployment.
  4. Select the Deployment to update.
  5. Select the Image to use for the deployment.
  6. Click Deploy to begin the deployment.

2. From a deployment page

  1. Head over to the Deployment page.
  2. Click on Deploy.
  3. Select the Image to use for the deployment.
  4. Click Deploy to begin the deployment.
← Create a new projectManage a project →
© 2020 Altostra, Inc.