亚马逊 CodeCatalyst 不再向新买家开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [如何从中迁移 CodeCatalyst](migration.md)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 为开发环境指定通用 devfile 映像
<a name="devenvironment-universal-image"></a>

默认*通用映像*包括可用于 IDE 的最常用的编程语言和相关工具。如果未指定图像，则 CodeCatalyst 提供此图像并包含由维护的工具 CodeCatalyst。要接收有关新映像版本的通知，请参阅[使用 SNS 订阅通用映像通知](#devenvironment-universal-notifications)。

Amazon CodeCatalyst 积极支持以下开发者文件镜像：


| 映像版本 | 映像标识符 | 
| --- | --- | 
| Universal image 4.0 | public.ecr.aws/aws-mde/universal-image:4.0 | 
| Universal image 5.0 | public.ecr.aws/aws-mde/universal-image:5.0 | 

**注意**  
您还可以使用 `public.ecr.aws/aws-mde/universal-image:latest` 获取最新映像，当前为 `public.ecr.aws/aws-mde/universal-image:5.0`。

CodeCatalyst 已弃用以下图片。您仍然可以使用这些映像，但它们不会缓存在构建主机上，因此将导致开发环境的启动时间更长。


| 映像版本 | 映像标识符 | 弃用日期 | 
| --- | --- | --- | 
| Universal image 1.0 | public.ecr.aws/aws-mde/universal-image:1.0 | 2024 年 8 月 16 日 | 
| Universal image 2.0 | public.ecr.aws/aws-mde/universal-image:2.0 | 2024 年 8 月 16 日 | 
| Universal image 3.0 | public.ecr.aws/aws-mde/universal-image:3.0 | 2025 年 7 月 30 日 | 

**注意**  
如果你使用的是 AWS Cloud9，升级到后自动完成功能将不适用于 PHP、Ruby 和 CSS。`universal-image:3.0`

**Topics**
+ [使用 SNS 订阅通用映像通知](#devenvironment-universal-notifications)
+ [通用映像 4.0 运行时版本](#devenvironment-universal-runtimes-4.0)
+ [通用映像 5.0 运行时版本](#devenvironment-universal-runtimes-5.0)

## 使用 SNS 订阅通用映像通知
<a name="devenvironment-universal-notifications"></a>

CodeCatalyst 提供通用的图像通知服务。您可以使用它来订阅亚马逊简单通知服务 (SNS) Simple Notification Service 主题，该主题将在 CodeCatalyst 通用图像更新发布时通知您。有关 SNS 主题的更多信息，请参阅 [What is Amazon Simple Notification Service?](https://docs.aws.amazon.com/sns/latest/dg/welcome.html)。

每当发布新的通用图像时，我们都会向订阅者发送通知；本节介绍如何订阅 CodeCatalyst 通用图像更新。

**示例消息**

```
{
    "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"
}
```

**使用 Amazon SNS 控制台订阅 CodeCatalyst 通用图像更新**

1. 打开 Amazon SNS 控制台以显示[控制面板](https://console.aws.amazon.com/sns/v2/home)。

1. 在导航栏中，选择您的 AWS 区域。

1. 在导航窗格中，选择**订阅**，然后选择**创建订阅**。

1. 在**主题 ARN** 中，输入 `arn:aws:sns:us-east-1:089793673375:universal-image-updates`。

1. 在**协议**中，选择**电子邮件**。

1. 在**端点**中，提供一个电子邮件地址。此电子邮件地址将用于接收通知。

1. 选择**创建订阅**。

1. 您将收到一封主题为 “AWS 通知-订阅确认” 的确认电子邮件。打开这封电子邮件，然后选择**确认订阅**。

**使用 Amazon SNS 控制台取消订阅 CodeCatalyst 通用图像更新**

1. 打开 Amazon SNS 控制台以显示[控制面板](https://console.aws.amazon.com/sns/v2/home)。

1. 在导航栏中，选择您的 AWS 区域。

1. 在导航窗格中，选择**订阅**，然后选择要取消的订阅。

1. 选择**操作**，然后选择**删除订阅**。

1. 选择**删除**。

## 通用映像 4.0 运行时版本
<a name="devenvironment-universal-runtimes-4.0"></a>

下表列出了对 `universal-image:4.0` 可用的运行时。


**`universal-image:4.0` 运行时版本**  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/codecatalyst/latest/userguide/devenvironment-universal-image.html)

## 通用映像 5.0 运行时版本
<a name="devenvironment-universal-runtimes-5.0"></a>

下表列出了对 `universal-image:5.0` 可用的运行时。


**`universal-image:5.0` 运行时版本**  

| 运行时名称  | 版本 | 特定主要和最新次要版本 | 
| --- | --- | --- | 
| aws cli |  2.25  |  `aws-cli: 2.x`  | 
| docker compose |  2.34  |  `docker-compose: 2.x`  | 
| dotnet |  8.0  |  `dotnet: 8.x`  | 
| golang |  1.24  |  `golang: 1.x`  | 
| java |  corretto21  |  `java: corretto21.x`  | 
| nodejs |  22.0  |  `nodejs: 22.x`  | 
| php |  8.3.16  |  `php: 8.x`  | 
| python |  3.12  |  `python: 3.x`  | 
| ruby |  3.4.2  |  `ruby: 3.x`  | 
| terraform |  1.10.5  |  `terraform: 1.x`  |