Skip to main content

ECS Re-Deployments

Overview​

This document outlines the process for redeploying the ArcAPI and ArcAPI-Workers services on AWS Elastic Container Service (ECS).

Why force a new deployment?
Forcing a new deployment is necessary when environment variables are changed for a service. ECS does not automatically apply environment variable updates unless a new deployment is triggered. If you modify environment variables without redeploying, the changes will not take effect until you force a new deployment. This process should only be used in this scenario.

AWS Account Access​

Access the AWS Console through SSO:

Environment Configuration​

Regions​

  • Dev Environment: us-east-1
  • Production Environment: us-west-2

ECS Cluster and Services​

  • Cluster: dev-API
  • Services (Dev, us-east-1):
    • ArcAPI
    • ArcAPI-Workers

Note: Service and cluster names may differ in other regions (e.g., production in us-west-2). Adjust names accordingly when working outside the dev environment.

Re-Deployment Process​

Step 1: Navigate to ECS​

  1. Login to AWS Console using the SSO link above
  2. Navigate to Amazon Elastic Container Service
  3. Select Clusters from the left sidebar
  4. Click on the dev-API cluster

Step 2: Re-Deploy ArcAPI Service​

  1. In the cluster view, click on the Services tab
  2. Select the ArcAPI service
  3. Click the Update dropdown button
  4. In the deployment configuration section:
    • Check Force new deployment
    • Leave other settings unchanged
  5. Click Update to start the deployment

Step 3: Re-Deploy ArcAPI-Workers Service​

  1. Return to the Services tab in the dev-API cluster
  2. Select the ArcAPI-Workers service
  3. Click the Update dropdown button
  4. In the deployment configuration section:
    • Check Force new deployment
    • Leave other settings unchanged
  5. Click Update to start the deployment