Upgrade

Overview

This topic provides instructions for upgrading the Upwind components in an ECS cluster using the Amazon Fargate launch type. Upwind provides newer versions so you can keep your environment up-to-date. Newer versions can include bug fixes, security enhancements, and other improvements for the Upwind componenets.

Upgrade

Follow the detailed steps corresponding to your original installation method:

Terraform

If you previously installed the Upwind components using a Terraform module, follow these steps to upgrade them:

1. Navigate to the directory for your Terraform project in your terminal. This directory contains your current Terraform configuration.

   cd /path/to/my-terraform-project

2. Open the main.tf file within this directory.

3. Locate the aws_ecs_fargate module block within the main.tf file. Update the source variable to point to the new module source path. For example:

   module "aws_ecs_fargate" {
     source = "https://get.upwind.io/.../[OLD].tar.gz"
     source = "https://get.upwind.io/.../[NEW].tar.gz"
   }
   note

   The URL of the latest module source can be found in the Upwind Management Console . All Terraform modules will be migrated to the Terraform Registry in the future, allowing the use of Version Constraints .

4. Before proceeding, ensure that your configuration settings are tailored to your environment. This includes network configurations and compatibility settings specific to your ECS cluster setup.

5. Run the following command to initialize Terraform within the project directory:

   terraform init -upgrade

6. Run the following command to apply the Terraform configuration and update the necessary resources:

   terraform apply

7. Review the changes that Terraform plans to make and enter yes when prompted to confirm the changes. Terraform will update the necessary infrastructure and resources in your AWS account to upgrade the Upwind components, based on the provided configuration.

8. Once the terraform apply command has successfully executed, the necessary infrastructure and resources should be upgraded within a few moments. A success message will appear in the console to indicate the successful upgrade of the Upwind components.

AWS CloudFormation

If you previously installed the Upwind components using a CloudFormation stack, follow these steps to upgrade them:

1. Sign in to the AWS Management Console and open the AWS CloudFormation console .

2. On the Stacks page, select the running stack that you want to update.

3. In the stack details pane, choose Update.

4. Select Replace existing template and specify the location of the updated template in the Specify template section.

5. For Template source choose Amazon S3 URL, and enter or paste the URL for the template, and then choose Next.

   note

   The URL of the latest template can be found in the Upwind Management Console .

6. Review the existing parameter values on the Specify stack details page and click Next.

7. Check the Capabilities section and acknowledge that the template may create IAM resources.

8. Choose Next to continue.

9. Review the stack information and the changes that you submitted.

10. When you are satisfied with your changes, choose Update stack.

    note

    At this point, you also have the option to view the change set to review your proposed updates more thoroughly. To do so, choose View change set instead of Update stack. CloudFormation displays the change set generated based on your updates. When you are ready to perform the stack update, choose Execute.

11. CloudFormation displays the stack details page for your stack, with the Events pane selected. Your stack now has a status of UPDATE_IN_PROGRESS. After CloudFormation has successfully finished updating the stack, it sets the stack status to UPDATE_COMPLETE.

For more information, consult the AWS documentation on updating CloudFormation stacks directly.

Test Connectivity

To verify the connectivity of your ECS cluster, run the following command:

aws ecs describe-services \
  --cluster [your-cluster-name] \
  --services upwind-cluster-manager

Expected Output:

[
  {
    "ServiceName": "upwind-cluster-manager",
    "ServiceStatus": "ACTIVE",
    "DesiredCount": 1,
    "RunningCount": 1,
    "DeploymentStatuses": ["PRIMARY"],
    "DeploymentsCount": 1
  }
]

Check	Description
ServiceStatus	Ensure ServiceStatus is ACTIVE for both services.
DesiredCount and RunningCount for upwind-cluster-manager	Ensure both counts are equal, typically set to 1.
DeploymentStatuses	Ensure all deployments have PRIMARY status, and the DeploymentCount matches the expected number.

Troubleshooting

If you encounter issues during deployment or operation, consult the Troubleshooting guide for solutions and best practices.