Skip to content

Understanding Deployments

Quant Cloud simplifies the deployment of your containerized applications. For applications where the image source is set to your organization’s internal Quant Cloud Registry, a common workflow involves building your Docker image, pushing it to this registry, and then triggering a redeploy within the Quant Cloud portal.

The portal provides a “Deployment Instructions” section, accessible from the Application Details page or Environment Details page, to guide you through this process.

Typical Deployment Steps

If your application is configured to use an image pushed to the internal repository, the instructions will generally guide you through the following:

  1. Build your Docker Image:

    • You start by building your Docker image locally using a Dockerfile in your project.
    • Example: docker build -t your-image-name:your-tag .
      • Replace your-image-name:your-tag with a meaningful name and version for your image (e.g., my-web-app:v1.2.0, api-service:latest).
  2. Log in to the ECR Registry:

    • To push images to the Quant Cloud ECR, you need to authenticate your Docker client with the registry associated with your organization.
    • The portal provides an easy way to get the necessary login command (e.g., via an “Get Registry Login Command” button). This command retrieves temporary credentials and logs you in. You’ll copy this command from the portal and run it in your terminal.
  3. Tag Your Local Image:

    • Once logged in, you need to tag your locally built image with the full ECR repository URI. This URI is specific to your application and environment. The “Deployment Instructions” modal will display this URI.
    • The format is typically [aws_account_id].dkr.ecr.[region].amazonaws.com/[repository-name]:[tag].
    • Example:
      Terminal window
      docker tag your-image-name:your-tag [ECR_REPOSITORY_URI]:your-tag
      (e.g., docker tag my-web-app:v1.2.0 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-app-repo:v1.2.0)
    • The modal will usually provide the exact [ECR_REPOSITORY_URI] and an example tagging command.
  4. Push the Tagged Image to ECR:

    • After tagging, push the image to the ECR repository.
    • Example:
      Terminal window
      docker push [ECR_REPOSITORY_URI]:your-tag
      (e.g., docker push 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-app-repo:v1.2.0)
  5. Redeploy the Application in Quant Cloud:

    • Once the new image version is pushed to ECR, navigate to your application or environment in the Quant Cloud portal.
    • Use the “Redeploy” button (or a similar action). This tells Quant Cloud to pull the latest version of the image (or the specific tag you pushed, if your environment is configured to use a specific tag) from ECR and update the running services.
    • If your environment’s image identifier is set to a mutable tag like latest, Quant Cloud will pull the image that latest currently points to in ECR. If it’s set to an immutable tag (e.g., v1.2.0), you’ll need to ensure you pushed an image with that exact tag, or update the image identifier in your environment’s configuration to the new tag before redeploying.

These instructions are crucial for understanding how to update your application when using the internal Quant Cloud image registry. If your image source is set to an external registry (like Docker Hub), the process would involve pushing to that external registry, and then redeploying in Quant Cloud (which would then pull from the configured external source).