Release notes for AWS App2Container - AWS App2Container

Release notes for AWS App2Container

The following table describes the release history for AWS App2Container in descending date order.

Release date Version Details
December 17, 2024 1.48

Starting with App2Container version 1.48, only Windows Server 2016 and later Windows Server operating systems are supported. For Windows Server 2008 and 2012, you can use App2Container version 1.47.

  • Added bug fixes, including the following:

    • Fixed an issue where the containerize command would fail due to spaces in Windows service names.

November 22, 2024 1.47

This is the last version that is compatible with Windows Server 2008 and Windows Server 2012. If necessary for your operating system version, you can download the App2Container version 1.47 binary file for Windows and the corresponding file hash to verify the integrity of the download. For more information on installing App2Container, see Step 1: Install App2Container.

  • Removed IIS as a prerequisite for Windows services inventory.

  • Added support for .NET 9 applications.

  • Added bug fixes, including the following:

    • Improved error handling when integrating with FireLens for deployments to Amazon Elastic Container Service (Amazon ECS).

October 10, 2024 1.46
  • Updated the Lambda function for Amazon Elastic Container Service (Amazon ECS) deployments with gMSA to use Node.js 18.

  • Added bug fixes, including the following:

    • Improved the handling of file system changes during the creation of application archives.

    • Improved error handling for updating the Amazon ECS service when you deploy to Amazon ECS.

September 11, 2024 1.45
  • Launch templates are now used when you deploy to Amazon Elastic Compute Cloud (Amazon EC2) container instances for Amazon Elastic Container Service (Amazon ECS).

  • Added bug fixes, including the following:

    • Addressed an issue when files aren't found with the extract command.

    • Improved detection for subnets when you deploy to Amazon ECS in an existing VPC.

    • Improved error handling for invalid CPU and memory configurations when you deploy to Amazon ECS on AWS Fargate.

    • Addressed an issue where removing some sections from the pipeline.json file could cause App2Container to crash.

July 26, 2024 1.44

Enhanced logging for Jenkins input validation during pipeline deployment.

July 11, 2024 1.43

Improved Jenkins plugin detection during pipeline deployment.

July 3, 2024 1.42

Improved connection string detection for Windows applications.

June 14, 2024 1.41

Added support for Windows Server 2022 as a container host operating system.

June 10, 2024 1.40
  • Changed the default deployed version of Amazon Elastic Kubernetes Service (Amazon EKS) clusters to 1.30.

  • Updated the analyze command to use CentOS Stream 9 as the default base image on CentOS application server.

  • Added bug fixes, including the following:

    • Improved error handling when customized base images are used in the containerization process.

May 21, 2024 1.39 This release improves the detection of connection strings and configuration files for IIS .NET applications and Windows services.
May 2, 2024 1.38 Added bug fixes, including the following:
  • Improved error handling for insufficient disk space errors encountered during the containerization phase.

  • Improved detection for Windows authentication during the analysis phase.

March 8, 2024 1.37

Updated additional AWS Lambda functions for Amazon Elastic Kubernetes Service (Amazon EKS) deployments to use Python 3.9 and runtimes provided by Amazon Linux 2 (AL2).

  • Added bug fixes, including the following:

    • Improved error handling when customized base images are used in the containerization process.

February 22, 2024 1.36 Added bug fixes, including the following:
  • Fixed an issue where App2Container version 1.35 couldn’t run or be installed on Windows Server 2008.

February 14, 2024 1.35
  • Updated the AWS CloudFormation custom resources to use Node.js 18.

  • Updated the AWS Lambda functions for Amazon Elastic Container Service (Amazon ECS) and Amazon Elastic Kubernetes Service (Amazon EKS) deployments to use Python 3.9.

  • Clarified error messaging when containerization fails due to the host operating system and container operating system being incompatible.

  • Added detection for the command used to invoke Windows services when you use the analyze command.

  • Added bug fixes, including the following:

    • Fixed an issue where Windows deployments to Amazon ECS on Amazon EC2 could fail.

    • Fixed an issue where the analyze command would fail due to having wildcard expressions which contain square bracket characters ([ or ]) in the application's name. For more information, see about_Wildcards in the Microsoft documentation.

November 16, 2023 1.34

Added support for .NET 8 applications.

October 20, 2023 1.33
  • Added bug fixes, including the following:

    • Fixed an issue where the generate app-deployment command could fail if the container image was untagged.

    • Fixed an issue where the inventory command could encounter a runtime exception.

August 28, 2023 1.32
  • Adopted a new telemetry endpoint to collect metrics, logs, and command-generated artifacts.

  • Updated the SectionForMetricsService and SectionForUploadSupportBundleService statements in the example IAM policies for Amazon EKS, Amazon ECS, and App Runner to support the new telemetry endpoint. For more information, see Example IAM policies.

  • Added bug fixes, including the following:

    • Fixed an issue where generating a pipeline in AWS CodePipeline for Windows applications could fail.

    • Fixed an issue where containerization doesn’t wait long enough for health checks to pass.

    • Improved error handling for missing IAM permissions during deployment.

    • Fixed a bug with handling quotation marks in the paths for Windows services.

August 1, 2023 1.31
  • Changed the Windows build instances for AWS CodePipeline integration to use ECS-optimized AMIs.

  • Added bug fixes, including the following:

    • Fixed an issue with generated pipelines in AWS CodePipeline where builds could fail.

    • Fixed an issue where deployments to Amazon Elastic Kubernetes Service would fail in some newer AWS regions.

    • Fixed an issue where Application Load Balancers would not be created when deploying to Amazon EKS.

June 30, 2023 1.30
  • Added support to deploy Microsoft Azure DevOps pipelines from servers with operating systems other than Ubuntu.

  • Changed the default cluster instance type to c5.4xlarge when deploying to Amazon ECS with EC2 instances.

  • Changed the instance type to t3.medium for Windows container pipelines created in AWS CodePipeline.

  • Changed the default AWS CodeBuild environment type to Amazon Linux 2023 for all container pipelines created in CodePipeline.

  • Added bug fixes, including the following:

    • Fixed a bug where the remote analyze command was unable to access files on the application server if they required a second hop to a network drive.

    • Fixed a bug where remote workflows weren't successfully completing with Microsoft Azure DevOps pipelines, even with Windows Server 2019 worker machines.

    • Fixed a bug where deployments to Amazon EKS could indicate they were successful when the application container didn't function properly.

    • Improved error handling for when the operating system or architecture of the container image doesn't match that of the server running the Docker engine.

May 26, 2023 1.29
  • Changed the default deployed version of Amazon Elastic Kubernetes Service (Amazon EKS) to 1.26.

  • Added bug fixes, including the following:

    • Fixed a bug where the containerize command failed to handle Linux applications with the \n, \r, \t, \b, \f, or \v characters defined in environment variables.

    • Fixed a bug where deploying to Amazon EKS was failing when the existing stack could not be updated.

    • Fixed a bug where some App2Container commands would not complete for machines without internet connectivity.

May 4, 2023 1.28
  • Changed the Amazon Simple Storage Service (Amazon S3) object key prefix that App2Container uses when you upload AWS CloudFormation templates to Amazon S3 with either the generate app-deployment or generate pipeline command.

  • Changed the instance metadata version of Windows build instances to IMDSv2 when they integrate with AWS CodePipeline.

  • Added support for Amazon Linux 2023.

  • Changed the default installation from Java Development Kit (JDK) 11 to Amazon Corretto 11 when App2Container generates a Dockerfile.

  • Added bug fixes, including the following:

    • Removed the unnecessary creation of an Amazon EC2 key pair when you deploy to Amazon Elastic Container Service (Amazon ECS) on AWS Fargate.

    • Improved how errors are handled when AWS CloudFormation fails to create and update stacks.

    • Fixed a bug that caused the analysis phase to fail during discovery of database connection files over networked drives.

    • Fixed a bug that prevented detection of all ports for Windows services.

    • Changed how quotation marks are handled in the paths for Windows services.

    • Fixed a bug that caused Windows services to use an incorrect health check.

    • Changed how arguments are handled for the executable that a Windows services is using.

    • Fixed a bug that caused the generated name of S3 buckets for CodePipeline integration to be too long.

    • Fixed a bug that caused Azure DevOps pipelines for Linux applications to use an unsupported agent image.

    • Fixed a bug where a named profile would be required for the containerize command, even when you don't use an input archive from Amazon S3.

    • Fixed a bug so that you can use the generate app-deployment command while you specify the --deploy flag to prevent failure of S3 bucket validation.

April 20, 2023 1.27
Announcement

App2Container version 1.27 has been rolled back due to an issue with analyzing applications on Linux. We recommend that you run the app2container upgrade command to install the latest generally available version. For more information, see app2container upgrade command.

February 23, 2023 1.26
  • Changed the default instance metadata version to IMDSv2 for cluster instances when you create Amazon ECS and Amazon EKS clusters.

  • Introduced the generation of machine-based application IDs to ensure uniqueness of the application.

  • Added a bug fix, as follows:

    • Fixed a containerization issue when the application runs as a non-root user.

January 11, 2023 1.25
  • Changed default .NET Framework base image to version 4.8.

  • Added bug fixes, including the following:

    • Clarified error messaging when the containerize command fails while using the --build-only flag.

    • Clarified error messaging related to analyze command failures in Windows.

    • Fixed an issue causing a duplicate s3 pipeline bucket name across different accounts with same app id.

December 11, 2022 1.24
  • Added support for .NET 7 application.

  • Added bug fixes, including the following:

    • Fixed an issue when containerizing an application running as a different user on Linux.

November 15, 2022 1.23
  • Enhanced Amazon EKS deployment features to help you configure the deployment.json file with existing clusters more conveniently, as follows:

    • Added properties for CPU and memory limit configuration.

    • Added properties for ingress configuration with an AWS Application Load Balancer or using NGINX with an Network Load Balancer.

    • Added properties to set up DNS records for the deployed application.

    • Added properties to use with an AWS Certificate Manager (ACM) certificate for HTTPS deployments.

    • To better reflect inclusive language, the default git branch name is now main.

  • Added bug fixes, including the following:

    • Fixed a duplicate port issue with the analyze command.

    • Fixed an issue with uploading large log files with the upload-support-bundle command.

    • Fixed an issue with Firelens logging for Linux ECS deployments.

October 10, 2022 1.22

Added bug fixes, including the following:

  • Fixed an issue with the analyze command for complex Windows applications that include an IIS application that resides on a shared network drive.

  • Changed the containerize command so that it no longer adds IIS web applications to the default application pool when it generates containers for complex Windows applications.

  • The remote analyze and remote extract commands no longer require AWS Tools for Windows PowerShell to run on the remote application server.

  • Fixed a deployment validation issue for Amazon EKS application containers that specify an existing VPC.

  • Fixed an issue where App2Container doesn't update an application deployment if the AWS CloudFormation stack is not in a complete state.

September 16, 2022 1.21
  • Changed new Amazon EKS deployment version default to Amazon EKS version 1.22.

  • Added bug fixes, including the following:

    • Fixed an Amazon EKS deployment issue where Windows applications could be stuck in the ContainerCreating state.

    • Fixed an issue that can happen when App2Container deploys new application containers to Amazon EKS within an existing VPC.

September 9, 2022 1.20

Added bug fixes, including the following:

  • Fixed an analyze command issue for Java Tomcat applications on Linux that have a non-default web application directory.

August 30, 2022 1.19

Added bug fixes, including the following:

  • Fixed an issue with Windows applications where the local input archive path fails validation and causes an internal error.

  • Fixed an issue with the --input-json parameter for the remote configure command that affected Linux and Windows platforms.

  • Added validation for the generate pipeline command that returns an error if the Dockerfile.update file is missing.

August 2, 2022 1.18
  • Enhanced Azure DevOps support so that Amazon EKS deployments work without a kubectl-specific IAM user.

  • Added bug fixes, including the following:

    • Improved run time exception handling for AWS Secrets Manager secret retrieval.

    • Fixed a containerization issue for complex applications that use a cooperating application.

    • Fixed a Windows application issue that occurs when the file path is longer than 260 characters.

    • Fixed an issue that can occur when App2Container archives input from S3 URLs during containerization.

    • Fixed a containerization issue for Java 17 applications on Amazon Linux 2.

June 20, 2022 1.17
  • Support Microsoft Azure DevOps as a deployment pipeline.

  • Added bug fixes, including the following:

    • Added an error message response when you attempt to install App2Container from a version of the PowerShell command line interface that App2Container doesn't support. To run commands in PowerShell, App2Container requires version 5.0 or above.

    • Fixed an issue when Kubernetes authenticates with the latest version of the AWS CLI.

May 9, 2022 1.16
  • Added bug fixes, including the following:

    • Addressed an issue that occurs when analyzing ports used by the Windows Service.

    • Addressed an issue with application analysis when some Linux applications might not progress during a port connectivity test.

    • Addressed an issue with large Windows applications that caused the Windows CodePipeline to fail.

April 14, 2022 1.15
  • Optimized AWS App2Container installer size.

  • Deprecated MD5 checksum validation for the App2Container installer.

  • Made AWS profile setup optional during init.

  • Added bug fixes, including the following:

    • Added validation for S3 bucket name during init.

March 31, 2022 1.14

Added bug fixes, including the following:

  • Fixed an issue that caused the containerize command with the --build-only option specified to fail.

  • Fixed issue with missing path references that caused analyze command to fail.

  • Corrected upload issue for the support bundle when a panic error occurs.

  • Fixed null pointer issues for the following commands:

    • generate app-deployment

    • remote configure

  • Clarified messaging for AWS CloudFormation access denied error.

March 2, 2022 1.13

Added bug fixes, including the following:

  • Fixed an issue that caused the containerize command to fail when the --build-only option was specified.

  • Fixed JDK version check failures.

  • Fixed an issue with environment variables used in the application path for Windows servers.

  • Fixed incorrect container image tag assignment for some operating systems.

  • Fixed an issue that reported success metrics when the remote command failed.

February 16, 2022 1.12

Fixed an issue that caused remote execution commands to fail in Windows.

February 09, 2022 1.11

Added bug fixes, including the following:

  • Use CentOS Stream as the base image for applications containerized on the CentOS platform.

  • Added an explicit check for the tar command on Linux.

  • Fixed an issue related to checking application images in Amazon ECR.

  • Fixed an issue related to early container removal for pre-validation.

January 14, 2022 1.10
  • Removed dependencies on Amazon ECR and Docker plugins for Jenkins pipelines.

  • Added bug fixes, including the following:

    • Added validation for PowerShell Version less than 5.0.

    • Fixed analyze command to handle paths with %SystemDrive%.

December 8, 2021 1.9
  • Added end-to-end workflow support for ASP.NET Core applications running on Linux, including single file applications.

  • Added bug fixes, including the following:

    • Fixed publicApp parameter issue in the deployment.json file.

    • Added user validation for existing Jenkins pipelines.

    • Fixed an issue with incremental deployments on failed CloudFormation stacks.

    • Fixed intermittent failure of Amazon EKS deployments on Windows.

November 24, 2021 1.8
  • Added support for Jenkins pipeline deployment.

  • Added support for incremental deployments of service and infrastructure changes to Amazon ECS, Amazon EKS, and App Runner auto-deployments.

  • Added automatic pre-validation for the containerize command, with the --no-validate option to skip that step.

  • Added bug fixes, including the following:

    • Fixed an issue with the upgrade command that caused the download to time-out.

    • Fixed an Amazon ECS deployment issue caused by the wrong version of Windows 2016 being used as the base AMI.

    • Fixed an issue with selecting the container image for Amazon ECS when Firelens logging is enabled.

    • Fixed issue with application analysis that missed application ports bound to a loopback.

November 4, 2021 1.7

Upgraded AWS Lambda Node.js runtime to 14.x in CloudFormation templates to fix Amazon ECS deployment issue.

October 28, 2021 1.6
  • Added support for Windows application deployment to ECS Fargate.

  • Optimized Docker image sizes on Linux by using the Java JRE instead of the JDK.

    If your application needs to use the JDK, you can edit the Dockerfile that is produced by the containerize command. For more information, see Troubleshoot Java applications on Linux.

  • Updated default version for new Amazon EKS deployments to Amazon EKS version 1.19.

  • Added automatic filtering for the inventory command on Linux, to suppress reporting of standard Java processes that are running on the application server.

  • Added bug fixes, including the following:

    • Improved tagging for EC2 instances created by SSM documents.

    • Fixed containerize command issue with lowercase Windows drive names.

    • Fixed deployment issue for Docker image tags.

    • Fixed repeated ports in the analysis.json file.

    • Fixed server backup issue for IIS site with encrypted password.

    • Fixed Windows Active Directory issue for containerization and deployment.

July 26, 2021 1.5
  • Added support for containerizing complex Windows applications.

  • Added support for Amazon EKS tagging.

  • Added support for pipeline tagging.

  • Added bug fixes, including the following:

    • Reclassified DockerInvalidImageError for clarity.

    • Fixed App Runner deployment error that occurs when the local App Runner container is still running at deployment time.

    • Fixed containerization error when analysis.json has escaped characters.

May 20, 2021 1.4
  • Added support for deployments to AWS App Runner.

  • Added support for reuse of existing Active Directory security groups with gMSA.

  • Added bug fixes, including the following:

    • Fixed containerization of Windows applications that use a secondary drive mount.

    • Clarified some messaging on actionable errors.

    • Fixed an issue that resulted in incorrect analysis of RHEL Java processes.

    • Fixed issues related to symbolic links in the application server that resulted in larger than necessary image sizes.

March 29, 2021 1.3
  • Added support for Amazon EC2 instance profiles.

  • Added support for Amazon EC2 Nitro instance types in App2Container deployments for Windows applications.

  • Added support for Windows Server Core Version 2004 base images for containerized Windows applications.

  • The container base image for Windows applications now defaults to match the OS version for the server that runs containerization.

  • The base image for Windows Amazon ECS deployment artifacts matches the container base image.

  • Added bug fixes, including the following:

    • Fixed issue related to symbolic links during containerization.

    • Fixed issue related to spaces in paths in Dockerfiles.

    • Fixed issues related to the Windows remote setup script.

December 21, 2020 1.2
  • Added capability to run commands remotely.

  • Added custom tag support for deployment resources.

  • Added support for HTTPS endpoints and ACM-based certificate management for Amazon ECS deployments.

  • Added bug fixes, including the following:

    • Fixed containerization issue on Linux when unidentified base image uses default image.

    • Added exclusion for AWS credentials when containerizing Linux applications.

November 24, 2020 1.1
  • Added support for Active Directory authenticated Windows application deployments to Amazon EKS using gMSA.

  • Added support for named profile overrides to commands that interact with AWS.

  • Enabled automatic log upload and adjusted console messaging when errors occur (requires IAM policy update).

  • Added capability to manually upload logs and other artifacts with the upload-support-bundle command (requires IAM policy update).

  • Added bug fixes, including the following:

    • Updated CloudFormation templates for Amazon EKS deployments to address previous issues.

    • Fixed internal/user error classification.

    • Fixed upgrade errors to point to the correct log file.

    • Added an explicit check to validate use of Docker version 17.07 or above.

September 15, 2020 1.0.2
  • Added FireLens logging support.

  • Added container image validation to pipeline generation.

  • Added bug fixes, including the following:

    • Removed execution role in template if Windows is specified.

    • Fixed template to reflect CloudFormation API change.

    • Fixed autocomplete installation bug.

    • Fixed dark font for Windows errors.

    • Improved error messaging for command execution errors.

    • Fixed containerize error where included file is not valid.

August 5, 2020 1.0.1
  • Improved memory usage while archiving in Windows.

  • Added support for containerizing individual applications running in Tomcat and JBoss standalone frameworks.

  • Added schema version and unhealthy version checks.

  • Added bug fixes, including the following:

    • Fixed handling for .NET Windows app running on alternative drives (not C).

    • Fixed COPY command failure in DockerFile.

    • Access denied error now throws user error.

    • Added automatic removal of characters that are not allowed in AppId.

    • Optimized Windows container image size for websites with multiple apps.

    • Fixed error handling for input arguments validation.

    • Fixed Dockerfile generation failure when dynamic logging is enabled.

    • EKS CloudFormation templates are now compatible with the new CloudFormation custom resource API.

June 30, 2020 1.0.0 Initial release.