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

# 将自定义标头从构建规范和 amplify.yml 中迁移出来
<a name="migrate-custom-headers"></a>

以前，要为应用程序指定自定义 HTTP 标头，要么在 Amplify 控制台中编辑构建规范，要么下载并更新 `amplify.yml` 文件并将其保存到项目的根目录中。强烈建议您将自定义标头从构建规范和 `amplify.yml` 文件中迁移出来。

在 Amplify 控制台的**自定义标头**部分中指定自定义标头，或者通过下载和编辑 `customHttp.yml` 文件来指定自定义标头。

**迁移 Amplify 控制台中存储的自定义标头**

1. 登录 AWS 管理控制台 并打开 [Amplify](https://console.aws.amazon.com/amplify/) 控制台。

1. 选择要执行自定义标头迁移的应用程序。

1. 在导航窗格中，依次选择**托管**和**构建设置**。在**应用程序构建规范**部分，您可以查看应用程序的构建规范。

1. 选择**下载**以保存当前构建规范的副本。稍后如果需要恢复任何设置，您可以引用此副本。

1. 下载完成后，选择**编辑**。

1. 请记下文件中的自定义标头信息，因为稍后将在步骤 9 中使用这些信息。在**编辑**窗口中，从文件中删除所有自定义标头，然后选择**保存**。

1. 在导航窗格中，依次选择**托管**、**自定义标头**。

1. 在**自定义标头**页面中选择**编辑**。

1. 在**编辑自定义标头**窗口中，输入您在步骤 6 中删除的自定义标头的信息。

1. 选择**保存**。

1. 重新部署您想要将新自定义标头应用到的任何分支。

**将自定义标头从 amplify.yml 迁移到 customHttp.yml**

1. 导航到当前部署在应用程序根目录中的 `amplify.yml` 文件。

1. 在选定的代码编辑器中打开 `amplify.yml` 文件。

1. 请记下文件中的自定义标头信息，因为稍后将在步骤 8 中使用这些信息。删除文件中的自定义标头。保存并关闭 文件。

1. 登录 AWS 管理控制台 并打开 [Amplify](https://console.aws.amazon.com/amplify/) 控制台。

1. 选择要为其设置自定义标头的应用程序。

1. 在导航窗格中，依次选择**托管**、**自定义标头**。

1. 在**自定义标头**页面中选择**下载**。

1. 在您选择的代码编辑器中打开下载的 `customHttp.yml` 文件，然后输入您在步骤 3 中从 `amplify.yml` 中删除的自定义标头的信息。

1. 将编辑后的 `customHttp.yml` 文件保存在项目的根目录中。如果您使用的是 monorepo，请将文件保存在存储库的根目录中。

1. 重新部署应用程序以应用新的自定义标头。
   + 对于 CI/CD 应用程序，请从包含新`customHttp.yml`文件的 Git 存储库中执行新构建。
   + 对于手动部署应用程序，请在 Amplify 控制台中再次部署该应用程序，并添加包含您上传的构件的新 `customHttp.yml` 文件。

**注意**  
在 `customHttp.yml` 文件中设置并部署在应用程序根目录中的自定义标头，将覆盖在 Amplify 控制台的**自定义标头**部分中定义的自定义标头。