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

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

# 设置并登录 CodeCatalyst
<a name="setting-up-topnode"></a>

您可以在 CodeCatalyst 中设置两种类型的空间：支持 AWS 构建者 ID 用户的空间，以及支持身份联合验证的空间（通过 IAM Identity Center 管理 SSO 用户和组）。AWS 构建者 ID 空间中的用户使用其 AWS 构建者 ID 登录 CodeCatalyst，而在设置了身份联合验证的空间中，用户使用与该空间相关联的公司 SSO 门户登录 CodeCatalyst。

**注意**  
CodeCatalyst 用户名的最小长度为 3 个字符，最大长度为 100 个字符。超过 100 个字符的用户名将被截断。这可能导致一个用户名看起来与另一个 100 个字符的用户名重复。有关更多信息，请参阅 [由于用户名被截断，我无法以新用户身份访问我的 BID 空间，或无法将其添加为新的 SSO 用户](troubleshooting.md#troubleshoot-username-truncated)。

本指南提供了设置和管理 AWS 构建者 ID 空间的步骤。要使用 CodeCatalyst AWS 构建者 ID 空间，您需要使用用户设置和登录 CodeCatalyst 时使用的 AWS 构建者 ID 来设置 CodeCatalyst。

《CodeCatalyst Administrator Guide》**中提供了设置和管理支持身份联合验证的空间的步骤。要使用为身份联合验证设置的空间，请参阅《Amazon CodeCatalyst Administrator Guide》中的 [Setup and administration for CodeCatalyst spaces](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/what-is.html)。

此部分提供了在具有 AWS 构建者 ID 空间的 Amazon CodeCatalyst 中工作的两种常见设置路径：作为第一个用户创建空间和项目，以及接受加入现有空间或项目的邀请。这些设置工作流截然不同。下图显示了这两个注册流程：

1. 在第一种情况下，您需要为自己的公司、团队或小组创建和设置空间，然后创建一个项目，接下来才能邀请他人使用这些资源。您必须提供一个 AWS 账户用于计费目的，不过仍可在其中默认使用免费套餐。

1. 在第二种情况下，如果您通过接受项目邀请加入 CodeCatalyst，那么其他人已经为您创建了空间和项目。不过，您仍然需要配置自己的个人资料，以便开始与他人合作。

![\[注册并创建一个您可以邀请成员加入的空间\]](http://docs.aws.amazon.com/zh_cn/codecatalyst/latest/userguide/images/sign-up-types.png)


**提示**  
CodeCatalyst 使用空间对项目和资源进行分组。首次注册 CodeCatalyst 时，系统会提示您创建空间和项目。

无论您是要注册来创建空间和项目，还是在接受邀请时进行注册，您都会创建一个 AWS 构建者 ID，用于登录 CodeCatalyst。要创建 AWS 构建者 ID，您需要提供用于登录 AWS 应用程序的全名、密码和电子邮件地址。此后，您将使用电子邮件和密码登录 CodeCatalyst。您还可以使用此 AWS 构建者 ID 登录使用 AWS 构建者 ID 凭证的其他应用程序。

在 CodeCatalyst 和 AWS 构建者 ID 中，会根据您的登录信息生成*个人资料*。您的个人资料包含您在 CodeCatalyst 项目中对语言和通知设置的偏好。

**提示**  
如果您在注册 Amazon CodeCatalyst 个人资料时遇到任何问题，请按照页面上提供的步骤操作。如果您需要其他帮助，请参阅[注册时出现的问题](ipa-troubleshooting.md#id-troubleshooting-sign-up)。

**Topics**
+ [创建新的空间和开发角色（无需邀请即可开始）](sign-up-create-resources.md)
+ [接受邀请并创建 AWS 建筑商 ID](sign-up-sign-in.md)
+ [使用 AWS 构建者 ID 登录](id-how-to-sign-in.md)
+ [使用 SSO 登录](sign-in-sso.md)
+ [查看用户的所有空间和项目](home.md)
+ [查看和管理 CodeCatalyst 个人资料](view-profiles.md)
+ [设置为 AWS CLI 与一起使用 CodeCatalyst](set-up-cli.md)

# 创建新的空间和开发角色（无需邀请即可开始）
<a name="sign-up-create-resources"></a>

 CodeCatalyst 无需邀请您加入现有空间或项目，即可注册 Amazon。完成后，您将在创建 AWS 建筑商 ID 后创建空间和项目。作为创建空间的一部分，您需要添加一个 AWS 账户 用于计费目的。

**提示**  
如果您在注册 Amazon CodeCatalyst 个人资料时遇到任何问题，请按照该页面提供的步骤操作。如果您需要其他帮助，请参阅[注册时出现的问题](ipa-troubleshooting.md#id-troubleshooting-sign-up)。

对于刚开始 CodeCatalyst 没有项目或空间邀请的用户来说，这是一个可能的流程。

Mary Major 是一位对它感兴趣 CodeCatalyst 并决定试一试的开发者。她导航到 CodeCatalyst 控制台，选择注册并创建 AWS 建筑商 ID 的选项。Mary 提供了一个电子邮件地址和密码来创建她的 AWS Builder ID。她将能够使用自己的 AWS Builder ID 登录 CodeCatalyst 和其他应用程序。当被要求选择别名时，她将指定`MaryMajor`为将在中 CodeCatalyst 显示的 CodeCatalyst 用户名，其他项目成员也将使用该用户名来 @mention Mary。

接下来，Mary 会被自动引导创建一个空间。作为该流程的一部分，Mary 被要求将 AWS 账户 与她正在创建的空间关联起来，这样她就可以在自己的第一个项目构建和部署中看到示例代码。她添加了这些信息并创建了自己的空间，在这里她选择创建预览开发角色的选项，该角色可用于新空间中的项目。Mary 选择创建一个项目，然后查看项目蓝图列表。在查看了可用蓝图的信息后，她决定在第一个项目中尝试**现代化三层 Web 应用程序**蓝图。于是她填写必填字段，然后创建项目。项目准备就绪后，她可以看到一个项目摘要页面，其中包括最近的活动、项目代码链接以及自动构建和部署代码的工作流。她探索了代码和工作流，包括查看已部署的示例 Web 应用程序。喜欢她所看到的，她决定邀请一些同事参加这个项目，开始探索。 CodeCatalyst

当她有时间时，Mary 会配置她的 AWS Builder ID，使其 CodeCatalyst 使用多重身份验证 (MFA) 登录。配置 MFA 后，Mary 可以使用 CodeCatalyst 密码和经批准的第三方身份验证应用程序中的密码或令牌组合登录。 CodeCatalyst 

## 创建新空间和 IAM 角色
<a name="sign-up-first"></a>

按照以下步骤注册您的 Amazon CodeCatalyst 个人资料，创建空间，为您的空间添加账户、支持角色和开发者角色。

最后一个过程是创建和添加开发人员角色。开发人员角色是一 AWS 个 IAM 角色，可让您的 CodeCatalyst 工作流程访问 AWS 资源。开发者角色是用于管理的服务角色 AWS 服务 ，将在登录的账户中创建。服务角色是由一项服务担任、代表您执行操作的 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)。IAM 管理员可以在 IAM 中创建、修改和删除服务角色。该角色的名称为 `CodeCatalystWorkflowDevelopmentRole-spaceName`。有关角色和角色策略的更多信息，请参阅[了解 **CodeCatalystWorkflowDevelopmentRole-*spaceName*** 服务角色](ipa-iam-roles.md#ipa-iam-roles-service-role)。

**注意**  
作为安全最佳实践，仅向需要管理空间中 AWS 资源访问权限的管理用户和开发人员分配管理权限。

在开始之前，您必须准备好为拥有管理权限的账户提供一个 AWS 账户 ID。准备好 12 位数的 AWS 账户 身份证。有关查找您的 AWS 账户 ID 的信息，请参阅[您的 AWS 账户 ID 及其别名](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html)。

**以新用户身份注册**

1. 在开始使用 CodeCatalyst 控制台之前，请先打开 AWS 管理控制台，然后确保您登录时使用的账号与创建空间时使用的相同 AWS 账户 。

1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 在欢迎页中，选择**注册**。此时将显示**创建您的 AWS Builder ID** 页面。您的 AWS 建筑商 ID 是您为登录而创建的身份。它和... 不一样 AWS 账户。

1. 在**您的电子邮件地址**中，输入您要关联的电子邮件地址 CodeCatalyst。然后选择**下一步**。

1. 在 “**您的姓名**” 中，提供您希望在使用 AWS 构建器 ID 的应用程序中显示的名字和姓氏。允许使用空格。这将是你的 AWS Builder ID 个人资料名称，例如 **Mary Major**。您以后可以更改此名称。

   选择**下一步**。此时将显示**电子邮件验证**页面。

1. 验证码将发送到您指定的电子邮件中。在**验证码**中输入此验证码，然后选择**验证**。如果您在 5 分钟后仍未收到验证码，也没能在垃圾邮件或广告邮件文件夹中找到该验证码，请选择**重新发送验证码**。

1. 在我们核实验证码之后，请在**密码**和**确认密码**中输入符合要求的密码。

   选中确认您同意 AWS 客户协议和 AWS 服务条款的复选框，然后选择**创建 AWS Builder ID**。

1. 在**创建您的 CodeCatalyst 别名**页面上，输入您要在中用作唯一用户标识符的别名 CodeCatalyst。选择名字的缩写版本，不带空格，例如**MaryMajor**。其他 CodeCatalyst 用户会在评论和拉取请求中用它来 @mention 你。您的 CodeCatalyst 个人资料将包含您在 AWS 建造者 ID 中的全名和您的 CodeCatalyst 别名。您以后不能更改您的 CodeCatalyst 别名。

   您的全名和别名将显示在中的不同区域 CodeCatalyst。例如，您的个人资料名称会显示在活动源中列出的活动中，但项目成员会使用您的别名来 @ 您。

   选择**下一步**。页面将更新为显示**创建您的 CodeCatalyst 空间**部分。

1. 在**命名您的空间**中，输入您的空间名称。您以后不能更改此名称。
**注意**  
空间名称在各处必须是唯一的 CodeCatalyst。不能重复使用已删除空间的名称。

1. 在 **AWS 区域**下拉菜单中，选择要存储空间和项目数据的区域。您以后不能更改此区域。

1. 选择**下一步**。页面更新，显示添加 AWS 账户的页面。该账户将作为空间的计费账户。

1. 在 **AWS 账户 ID** 中，输入您要连接到空间的账户的十二位 ID。

   在 **AWS 账户验证令牌**中，复制生成的令牌 ID。系统会自动为您复制令牌，但您可能需要将其存储以便批准 AWS 连接请求。

1. 选择**前往 AWS 控制台进行验证**。

1. “**验证 Amazon CodeCatalyst 空间**” 页面将在中打开 AWS 管理控制台。这是 **Amazon CodeCatalyst 空间**页面。您可能需要登录才能访问该页面。

   在中 AWS 管理控制台，请务必选择您想要创建空间的相同 AWS 区域 位置。

   要直接访问该页面，请登录 a AWS 管理控制台 t https://console.aws.amazon.com/codecatalyst/ home/ 中的 Amazon CodeCatalyst Spaces。

   中的验证令牌字段会自动填充中生成的令牌 CodeCatalyst。 AWS 管理控制台 

1. （可选）在**已授权的付费套餐**下，选择**授权付费套餐（标准版、企业版）**，为您的计费账户启用付费套餐。
**注意**  
这不会将计费套餐升级到付费套餐。但是，这将进行配置， AWS 账户 以便您可以随时更改空间的计费等级。 CodeCatalyst您可以随时启用付费套餐。如果不进行此更改，则空间只能使用免费套餐。

1. 选择**验证空间**。

   这将显示**账户已验证**成功消息，表示已将该账户添加到空间。

1. 留在 “**验证 Amazon CodeCatalyst 空间**” 页面上。选择以下链接：**要为该空间添加 IAM 角色，请查看空间详细信息**。

   包含**CodeCatalyst 空间详细信息的**连接页面将在中打开 AWS 管理控制台。这是 **Amazon CodeCatalyst 空间**页面。您可能需要登录才能访问该页面。

1. 返回 CodeCatalyst 页面，然后选择 “**下一步**”。

1. 创建空间时会显示一条状态消息。创建空间后，会显示 CodeCatalyst 以下消息：**您的空间已准备就绪。最后一步是创建项目。**您可以执行以下操作之一：
   + 选择**暂时跳过**。
   + 为您的空间选择**创建第一个项目**。有关向您说明如何使用蓝图创建项目的教程，请参阅[教程：使用现代三层 Web 应用程序蓝图创建项目](getting-started-template-project.md)。
**注意**  
如果显示权限错误或横幅，请刷新页面并尝试再次查看该页面。

**要创建并添加 CodeCatalyst **CodeCatalystWorkflowDevelopmentRole-*spaceName*****

1. 在开始进入 CodeCatalyst 控制台之前 AWS 管理控制台，请先打开，然后确保您使用相同的 AWS 账户 空间登录帐户。

1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 导航到您的 CodeCatalyst 空间。选择**设置**，然后选择 **AWS 账户**。

1. 选择要创建角色的 AWS 账户 位置的链接。此时将显示 **AWS 账户 详细信息**页面。

1. **从中选择管理角色 AWS 管理控制台**。

   “**将 IAM 角色添加到 Amazon CodeCatalyst 空间**” 页面将在中打开 AWS 管理控制台。这是 **Amazon CodeCatalyst 空间**页面。您可能需要登录才能访问该页面。

1. 选择**在 IAM 中创建 CodeCatalyst 开发管理员角色**。此选项将创建一个服务角色，其中包含开发角色的权限策略和信任策略。该角色的名称为 `CodeCatalystWorkflowDevelopmentRole-spaceName`。有关角色和角色策略的更多信息，请参阅[了解 **CodeCatalystWorkflowDevelopmentRole-*spaceName*** 服务角色](ipa-iam-roles.md#ipa-iam-roles-service-role)。
**注意**  
此角色仅建议与开发者账户一起使用，并且使用`AdministratorAccess` AWS 托管策略，授予其在其中创建新策略和资源的完全访问权限 AWS 账户。

1. 选择**创建开发角色**。

1. 在连接页面的**可用的 IAM 角色**下 CodeCatalyst，查看添加到您的账户的 IAM 角色列表中的角色。`CodeCatalystWorkflowDevelopmentRole-spaceName`

1. 要返回您的空间，请选择 **Go to Amazon CodeCatalyst**。

**要创建并添加 CodeCatalyst **AWSRoleForCodeCatalystSupport****

1. 在开始进入 CodeCatalyst 控制台之前 AWS 管理控制台，请先打开，然后确保您使用相同的 AWS 账户 空间登录帐户。

1. 导航到您的 CodeCatalyst 空间。选择**设置**，然后选择 **AWS 账户**。

1. 选择要创建角色的 AWS 账户 位置的链接。此时将显示 **AWS 账户 详细信息**页面。

1. **从中选择管理角色 AWS 管理控制台**。

   “**将 IAM 角色添加到 Amazon CodeCatalyst 空间**” 页面将在中打开 AWS 管理控制台。这是 **Amazon CodeCatalyst Spaces** 页面。您可能需要登录才能访问该页面。

1. 在**CodeCatalyst 空间详情**下，选择**添加 Su CodeCatalyst pport 角色**。此选项将创建一个服务角色，其中包含预览开发角色的权限策略和信任策略。该角色的名称为 **AWSRoleForCodeCatalystSupport**，并且将附加唯一标识符。有关角色和角色策略的更多信息，请参阅[了解 **AWSRoleForCodeCatalystSupport** 服务角色](ipa-iam-roles.md#ipa-iam-roles-support-role)。

1. 在 “为 Su ** CodeCatalyst pport 添加角色**” 页面上，将默认角色保留为选中状态，然后选择**创建角色**。

1. 在 “**可用的 IAM 角色**” `CodeCatalystWorkflowDevelopmentRole-spaceName` 下 CodeCatalyst，查看添加到您的账户的 IAM 角色列表中的角色。

1. 要返回您的空间，请选择 **Go to Amazon CodeCatalyst**。

创建 AWS Builder ID、创建第一个空间并添加账户后，即可创建项目。有关更多信息，请参阅 [创建项目](projects-create.md)。如果这是您第一次使用 CodeCatalyst，我们建议从开始[教程：使用现代三层 Web 应用程序蓝图创建项目](getting-started-template-project.md)。

# 接受邀请并创建 AWS 建筑商 ID
<a name="sign-up-sign-in"></a>

在接受项目或空间邀请 CodeCatalyst 的同时，您可以注册 Amazon。作为接受邀请的一部分，系统将提示您创建 AWS 生成器 ID。您将使用您的 AWS 生成器 ID 访问中的资源 CodeCatalyst。

**提示**  
如果您需要其他帮助，请参阅[注册时出现的问题](ipa-troubleshooting.md#id-troubleshooting-sign-up)。

对于刚开始获得项目或空间邀请 CodeCatalyst 的用户来说，这是一个可能的流程。

Saanvi Sarkar 是一名开发者，他已收到以项目管理员身份加入 CodeCatalyst 项目的邀请。Saanvi 接受邀请，这将打开登录页面。 CodeCatalyst她选择注册，并提供电子邮件地址和密码来创建自己的 AWS 构建者 ID。Saanvi 将能够使用她的 AWS Builder ID 登录 CodeCatalyst 和其他应用程序。之后，她可以编辑个人资料，更改登录电子邮件地址或密码。当被要求选择别名时，Saanvi 将指定`SaanviSarkar`为将在中 CodeCatalyst 显示的 CodeCatalyst 别名，其他项目成员也将使用该别名来 @mention Saanvi。注册后，Saanvi 还可以将她的登录凭据用于其他使用 AWS Builder ID 凭证的应用程序。

完成注册后，Saanvi 会自动加入邀请中指定的 CodeCatalyst 项目和空间。该邀请还为她在项目和空间中的角色提供了预先确定的权限。在项目设置中，Saanvi 的别名显示在成员列表中，并带有向她分配的项目角色。为了使用中的源存储库 CodeCatalyst，Saanvi 需要花点时间创建个人访问令牌 (PAT)。在 CodeCatalyst 进行源代码更改或需要身份验证令牌的操作时，PAT 将用于身份验证。

当 Saanvi 处理项目时，她的别名就会在该项目的工作活动日志中列出。Saanvi 发布的事务和评论将显示她的别名，其他项目成员可以在回复中 @ 她。对于 @mention 另一位项目成员，Saanvi 会在他们的个人资料中查找他们的别名。 CodeCatalyst 

当她有时间时，Saanvi 会将她的 AWS Builder ID 配置为 CodeCatalyst 使用多重身份验证 (MFA) 登录。配置 MFA 后，Saanvi 可以使用 CodeCatalyst 密码和经 CodeCatalyst 批准的第三方身份验证应用程序中的密码或令牌组合登录。

## 接受邀请并创建 AWS 建筑商 ID
<a name="id-how-to"></a>

当你被邀请加入亚马逊的项目或空间时 CodeCatalyst，你会收到一封来自 notify@codecatalyst.aws 的电子邮件，要求你接受邀请。如果您已经拥有 AWS 建筑商 ID 并已登录 CodeCatalyst，则选择 “**接受邀请**” 将自动在浏览器选项卡中打开项目或空间。如果您未登录主机但拥有 AWS 生成器 ID，则系统会将您带到登录页面。有关更多信息，请参阅 [使用 AWS 构建者 ID 登录](id-how-to-sign-in.md)。

如果您没有 AWS 生成器 ID，则选择 “**接受邀请**” 将带您进入登录页面，您应该在其中选择创建 AWS 生成器 ID 的选项。

**重要**  
通过接受邀请并在开发环境中打开存储库，脚本可以在访问您的 CodeCatalyst 凭据的情况下执行。在继续操作之前，请确保您信任消息来源。

**接受邀请并创建 AWS 建筑商 ID**

1. 在邀请电子邮件中，选择**接受邀请**。

1. 在登录页面上，选择**未注册？ 创建您的 AWS 建筑商 ID**。
**提示**  
您的 AWS 建筑商 ID 是您为登录而创建的身份。它与 AWS 账户不同。

1. 在 “**创建您的 AWS 建造者 ID**” 页面的 “**电子邮件地址**” 中，输入要用作 AWS 建造者 ID 的电子邮件地址。

   在 “**您的姓名**” 中，提供您希望在使用 AWS 构建器 ID 的应用程序中显示的名字和姓氏。允许使用空格。这将是你的 AWS Builder ID 个人资料名称，例如 **Mary Major**。您以后可以更改此名称。

   选择**下一步**。

   验证码将发送到您指定的电子邮件中。在**验证码**中输入此验证码，然后选择**验证**。如果您在 5 分钟后仍未收到验证码，也没能在垃圾邮件或广告邮件文件夹中找到该验证码，请选择**重新发送验证码**。

1. 在核实了验证码之后，请在**密码**和**确认密码**中输入符合要求的密码。

1. 选择 “**创建 AWS 生成器 ID**”。

1. 在**创建您的别名**页面上，输入您要在中用作唯一用户标识符的别名 CodeCatalyst。选择名字的缩写版本，不带空格，例如**MaryMajor**。其他 CodeCatalyst 用户会在评论和拉取请求中用它来 @mention 你。您的 CodeCatalyst 个人资料将包含您在 AWS 建造者 ID 中的全名和您的 CodeCatalyst 别名。您无法更改您的 CodeCatalyst 别名。

   您的全名和别名将显示在中的不同区域 CodeCatalyst。例如，您的个人资料名称会显示在活动源中列出的活动中，但项目成员会使用您的别名来 @ 您。

   选择**创建别名**。您将进入受邀加入的项目或空间。

# 使用 AWS 构建者 ID 登录
<a name="id-how-to-sign-in"></a>

请执行以下步骤以登录您的 Amazon CodeCatalyst 个人资料。

**注意**  
您是否已注册一台设备来进行多重身份验证（MFA）？ 强烈建议您在 Amazon CodeCatalyst 中配置 MFA 以增强安全性。有关更多信息，请参阅[如何注册设备以便在多重身份验证中使用](mfa.md#id-how-to-register)。

**使用您的 AWS 构建者 ID 登录**

1. 通过访问 [https://codecatalyst.aws/](https://codecatalyst.aws/) 打开 CodeCatalyst 控制台。

1. 输入您的**电子邮件地址**。（可选）如果您想保存您的电子邮件地址以在将来登录时使用，请选择**保存我的电子邮件地址**。选择**继续**。

1. 输入您的**密码**。选择**登录**。如果您忘记了密码，请按照[我忘记密码了](troubleshooting.md#id-forgot-password)中的步骤操作。

## 受信任设备
<a name="id-trusted-device"></a>

在从登录页面中选择选项**这是受信任设备**后，Amazon CodeCatalyst 会将以后从该设备进行的所有登录视为已授权。只要您使用受信任设备，Amazon CodeCatalyst 就不会显示用于输入 MFA 代码的选项。一些例外情况包括使用新浏览器登录或您的设备获得未知 IP 地址时。

# 使用 SSO 登录
<a name="sign-in-sso"></a>

请按照以下步骤使用 SSO 登录 Amazon CodeCatalyst。

要改用 AWS 构建者 ID 登录，请参阅[使用 AWS 构建者 ID 登录](id-how-to-sign-in.md)。

**使用 SSO 登录**

1. 通过访问 [https://codecatalyst.aws/](https://codecatalyst.aws/) 打开 CodeCatalyst 控制台。

1. 在**选择登录选项**下，选择**使用单点登录（SSO）**。

1. 在 **AWS Identity Center 应用程序名称**中，输入身份联合验证管理员提供的应用程序名称。

1. 选择**继续使用 IAM Identity Center**。

# 查看用户的所有空间和项目
<a name="home"></a>

您可以在用户主页上查看您的空间和项目的列表。用户主页显示用户所属的每个空间、用户在该空间中的角色（例如**空间管理员**）以及用户在其中拥有成员资格的每个空间中的项目的列表。

1. 通过访问 [https://codecatalyst.aws/](https://codecatalyst.aws/) 打开 CodeCatalyst 控制台。

1. 在浏览器中输入以下地址：[https://codecatalyst.aws/home](https://codecatalyst.aws/home)   
![\[用户主页列出了您作为其成员的所有空间和项目\]](http://docs.aws.amazon.com/zh_cn/codecatalyst/latest/userguide/images/user_home.png)

1. 选择要打开的空间或项目。如果您没有看到预期的空间或项目，则可能需要以其他用户的身份登录。

# 查看和管理 CodeCatalyst 个人资料
<a name="view-profiles"></a>

您可以在 Amazon 中查看用户资料 CodeCatalyst 以获取诸如电子邮件地址和 CodeCatalyst 别名之类的信息。您也可以更新您的个人资料和 AWS 建造者 ID。如果您忘记了密码，可以请求重置密码。

## 查看您的 CodeCatalyst 个人资料
<a name="view-your-profile"></a>

您在注册时提供的信息将用作登录亚马逊 CodeCatalyst 的凭证，这些信息将在您的个人资料中进行管理。这包括您的**姓名**、**昵称**和用于登录的**电子邮件地址** CodeCatalyst。

**注意**  
 AWS Builder ID **昵称**不是您的 CodeCatalyst 别名。您在注册时选择了您的 CodeCatalyst 别名。

**查看您的 CodeCatalyst 个人资料**

1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 在右上角，选择带有您的名字首字母的图标旁边的箭头，然后选择**我的设置**。 CodeCatalyst **我的设置**页面打开。

1. 要更新您的 AWS 建筑商 ID 电子邮件地址或密码，或者要设置 MFA，请选择**管理 AWS 建筑商** ID。将打开 “ AWS 生成器 ID” 页面。

## 查看其他用户的 CodeCatalyst 个人资料
<a name="view-another-user-profile"></a>

**查看其他用户的 CodeCatalyst 个人资料**

1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 在侧边导航中，选择**项目设置**。选择**成员**选项卡。查看您 CodeCatalyst项目的成员列表。

1. 选择要查找或 @ 的成员名称。**我的设置**页面将显示用户的别名、电子邮件地址和全名。使用 @mention 项目成员的 CodeCatalyst 别名。
**注意**  
用户的 AWS Builder ID **昵称**不是他们的 CodeCatalyst别名。他们在注册时选择了自己的 CodeCatalyst 别名。

   要查看项目中其他用户的配置文件，请在列表中选择其名称。

# 创建个人资料
<a name="your-profile"></a>

在中 CodeCatalyst，您的个人资料包含由 **AWS Builder ID** 管理的个人信息和中管理的设置 CodeCatalyst。
+ 您的个人资料的全名、电子邮件地址和密码按 **AWS 构建者 ID** 管理。您在注册时输入了这些信息。**当您将 MFA 设置为使用身份验证器应用程序登录时，会将您 CodeCatalyst 带到生成器 ID 页面。AWS **
+ CodeCatalyst 您的个人访问令牌 (PAT)、 CodeCatalyst 通知和语言首选项的设置可在的 **“我的设置”** 页面中进行管理 CodeCatalyst。有关更多信息，请参阅 [使用个人访问令牌向用户授予对存储库的访问权限](ipa-tokens-keys.md)。

**注意**  
您可以更新您的 AWS Builder ID 全名（CodeCatalyst 显示名称）和名字。但是，您无法更改您的 CodeCatalyst 别名。

## 更新 AWS 建筑商 ID 或电子邮件地址
<a name="id-update-profile"></a>

**更新您的地址 AWS 构建者 ID 或电子邮件地址**

1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 在右上角，选择带有您的名字首字母的图标旁边的箭头，然后选择**我的设置**。 CodeCatalyst**我的设置**页面打开。

1. 在个人资料页面上，选择**管理 AWS 生成器 ID**。这将打开 **AWS 构建者 ID** 页面。

1. 在该页面的左侧，选择**我的详细信息**。

1. 在**个人资料信息**下，选择**编辑**以更新您的**姓名**或**昵称**。如果您未指定昵称，**昵称**字段将体现全名中的名字。这不是你的 CodeCatalyst 别名。
**注意**  
这将更新 AWS 生成器 ID 的全名和名字。这不会更新您的 CodeCatalyst 别名。

   在**联系人信息**下，选择**编辑**以更新您的**电子邮件地址**。
**注意**  
这将更新您将用于登录的电子邮件地址 CodeCatalyst。

# 更改与 AWS 构建者 ID 关联的 CodeCatalyst 密码
<a name="id-change-password"></a>

按照以下说明操作，更改与您的 AWS 构建者 ID 关联的 Amazon CodeCatalyst 密码。

**注意**  
如果您使用 SSO 登录 CodeCatalyst，请让您的管理员更改您的密码。

**更改 CodeCatalyst 密码**

1. 通过访问 [https://codecatalyst.aws/](https://codecatalyst.aws/) 打开 CodeCatalyst 控制台。

1. 在右上角，选择带有您的名字首字母的图标旁边的箭头，然后选择**用户个人资料**。这将打开 CodeCatalyst **我的设置**页面。

1. 在个人资料页面上，选择**管理 AWS 构建者 ID**。这将打开 AWS 构建者 ID 页面。

1. 在该页面的左侧，选择**安全性**。

1. 选择**更改密码**，然后按照说明进行操作。

# 设置为 AWS CLI 与一起使用 CodeCatalyst
<a name="set-up-cli"></a>

您可以在 Amazon CodeCatalyst 控制台上处理大部分日常任务。但是，当你使用开发环境、个人访问令牌或事件日志 AWS CLI 时，你可能需要设置和配置 CodeCatalyst。必须先安装 AWS CLI 并配置配置文件，然后才能将其与一起使用 CodeCatalyst。<a name="how-to-set-up-cli"></a>

# 要设置 fo AWS CLI r CodeCatalyst
<a name="how-to-set-up-cli"></a>

1. 安装最新版本的 AWS CLI。如果您已经 AWS CLI 安装了某个版本，请确保该版本是最新版本并包含的命令 CodeCatalyst，并在需要时对其进行更新。要验证您是否安装了包含 CodeCatalyst 命令的版本，请打开命令提示符并运行以下命令：

   ```
   aws codecatalyst help
   ```

   如果您看到 CodeCatalyst 命令列表，则表示您的版本支持 CodeCatalyst。如果无法识别该命令，请将您的版本更新 AWS CLI 到最新版本。有关更多信息，请参阅 AWS Command Line Interface 用户指南 AWS CLI中的[安装或更新最新版本](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)的。

1. 如果您没有配置文件或者想要使用专门的命名配置文件，请运行**aws configure**命令来创建配置文件 CodeCatalyst。我们建议创建一个专门用于的命名配置文件 CodeCatalyst，但您也可以使用默认配置文件。有关更多信息，请参阅[配置基础知识](https://docs.aws.amazon.com//cli/latest/userguide/cli-configure-quickstart.html)。

1. 编辑配置`config`文件以添加用于连接的部分， CodeCatalyst 如下所示。`config` 文件位于 `~/.aws/config`（在 Linux 或 macOS 上）或 `C:\Users\USERNAME\.aws\config`（在 Windows 上）。

   ```
   [profile codecatalyst]
   region = us-west-2
   sso_session = codecatalyst
   
   [sso-session codecatalyst]
   sso_region = us-east-1
   sso_start_url = https://view.awsapps.com/start
   sso_registration_scopes = codecatalyst:read_write
   ```

1. 保存该文件。

1. 在尝试运行任何 CodeCatalyst 命令之前，请打开新的终端或命令提示符并运行以下命令来请求和检索`aws codecatalyst`用于运行命令的凭据。如果需要，请将 `codecatalyst` 替换为您的个人资料名称。

   ```
   aws sso login --profile codecatalyst
   ```

要查看 **codecatalyst** 命令示例，请参阅以下主题：
+ [使用个人访问令牌向用户授予对存储库的访问权限](ipa-tokens-keys.md)
+ [使用事件日志记录访问已记录的事件](ipa-logs.md)