Universal devfile images

The default universal image includes the most commonly used programming languages and related tools that can be used for your IDE. If no image is specified, CodeCatalyst provides this image and contains tools that are maintained by CodeCatalyst. CodeCatalyst supports up to two versions of the universal image at a time. To remain notified of new image releases, see Universal image notifications with SNS.

Amazon CodeCatalyst supports the following devfile images.

Image identifier
public.ecr.aws/aws-mde/universal-image:1.0

Note

You can use public.ecr.aws/aws-mde/universal-image:latest to get the latest universal image available.

Universal image notifications with SNS

CodeCatalyst provides a universal image notification service. You can use it to subscribe to an Amazon Simple Notification Service (SNS) topic that notifies you when CodeCatalyst universal image updates have been released. For more information about SNS topics, see What is Amazon Simple Notification Service?.

Whenever new universal images are released, we send notifications to subscribers; this section describes how to subscribe to CodeCatalyst universal image updates.

Sample message

{
    "Type": "Notification",
    "MessageId": "123456789",
    "TopicArn": "arn:aws:sns:us-east-1:1234657890:universal-image-updates",
    "Subject": "New Universal Image Release",
    "Message": {
        "v1": {
            "Message": "A new version of the Universal Image has been released. You are now able to launch new DevEnvironments using this image.",
            "image ": {
                "release_type": "MAJOR VERSION",
                "image_name": "universal-image",
                "image_version": "2.0",
                "image_uri": "public.ecr.aws/amazonlinux/universal-image:2.0"
            }
        }
    },
    "Timestamp": "2021-09-03T19:05:57.882Z",
    "UnsubscribeURL": "example url"
}

To subscribe to CodeCatalyst universal image updates using the Amazon SNS console

1. Open the Amazon SNS console to the Dashboard.

2. In the navigation bar, choose your AWS Region.

3. In the navigation pane, choose Subscriptions, and then choose Create subscription.

4. In Topic ARN, enter arn:aws:sns:us-east-1:089793673375:universal-image-updates.

5. In Protocol, choose Email.

6. In Endpoint, provide an email address. This email address will be used to receive notifications.

7. Choose Create subscription.

8. You will receive a confirmation email with the subject line "AWS Notification - Subscription Confirmation". Open the email and choose Confirm subscription.

To unsubscribe from CodeCatalyst universal image updates using the Amazon SNS console

1. Open the Amazon SNS console to the Dashboard.

2. In the navigation bar, choose your AWS Region.

3. In the navigation pane, choose Subscriptions and then select the subscription you want to unsubscribe from.

4. Choose Actions, and then choose Delete subscriptions.

5. Choose Delete.

Runtime versions

The following table lists the available runtimes for universal-image:1.0.

universal-image:1.0 runtime versions
Runtime name	Version	Specific major and latest minor version
aws cli	2.11	aws-cli: 2.x
docker compose	2.16	docker-compose: 2.x
dotnet	6.0	dotnet: 6.x
	7.0	dotnet: 7.x
golang	1.19	golang: 1.x
java	corretto11	java: corretto11.x
	corretto17	java: corretto17.x
nodejs	14.20	nodejs: 14.x
	16.19	nodejs: 16.x
openssl	1.0	openssl: 1.x
	1.1
php	7.2	php: 7.x
python	3.9	python: 3.x
	3.10
ruby	3.1	ruby: 3.x
terraform	1.4	terraform: 1.x