在 Linux, macOS 或 Unix 上设置到 Amazon CodeCommit 存储库的 SSH 连接的步骤

前往 http://aws.amazon.com，并选择注册，创建一个 Amazon Web Services 账户。

创建 IAM 用户或使用您的 Amazon Web Services 账户中的现有用户。确保您具有与该 IAM 用户关联的访问密钥 ID 和秘密访问密钥。有关更多信息，请参阅在 Amazon Web Services 账户中创建 IAM 用户。

登录Amazon Web Services Management Console，然后通过以下网址打开 IAM 控制台：https://console.aws.amazon.com/iam/。

在 IAM 控制台的导航窗格中，选择用户，然后选择要配置进行 CodeCommit 访问的 IAM 用户。

在 Permissions 选项卡上，选择 Add Permissions。

在 Grant permissions (授予权限) 中，选择 Attach existing policies directly (直接附加现有策略)。

从策略列表中选择 AWSCodeCommitPowerUser 或用于 CodeCommit 访问的其他托管策略。有关更多信息，请参阅适用于 CodeCommit 的 Amazon 托管式策略。

选择要附加的策略后，选择下一步：审核以审核要附加到 IAM 用户的策略列表。如果列表正确，选择 Add permissions。

有关 CodeCommit 托管策略以及与其他组和用户共享访问存储库的更多信息，请参阅共享存储库和 Amazon CodeCommit 的身份验证和访问控制。

在本地计算机上的终端中，运行 ssh-keygen 命令，并按照说明将文件保存到您的配置文件的 .ssh 目录中。

例如：

$ ssh-keygen

Generating public/private rsa key pair.
Enter file in which to save the key (/home/user-name/.ssh/id_rsa): Type /home/your-user-name/.ssh/ and a file name here, for example /home/your-user-name/.ssh/codecommit_rsa

Enter passphrase (empty for no passphrase): <Type a passphrase, and then press Enter>
Enter same passphrase again: <Type the passphrase again, and then press Enter>

Your identification has been saved in /home/user-name/.ssh/codecommit_rsa.
Your public key has been saved in /home/user-name/.ssh/codecommit_rsa.pub.
The key fingerprint is:
45:63:d5:99:0e:99:73:50:5e:d4:b3:2d:86:4a:2c:14 user-name@client-name
The key's randomart image is:
+--[ RSA 2048]----+
|        E.+.o*.++|
|        .o .=.=o.|
|       . ..  *. +|
|        ..o . +..|
|        So . . . |
|          .      |
|                 |
|                 |
|                 |
+-----------------+

这会生成：

ssh-keygen -t rsa -b 4096

运行以下命令显示公有密钥文件 (codecommit_rsa.pub) 的值：

cat ~/.ssh/codecommit_rsa.pub

复制该值。其内容类似于以下所示：

ssh-rsa EXAMPLE-AfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJB
gNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb2
5zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhc
NMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAw
DgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDAS=EXAMPLE user-name@ip-192-0-2-137

登录Amazon Web Services Management Console，然后通过以下网址打开 IAM 控制台：https://console.aws.amazon.com/iam/。

在 IAM 控制台的导航窗格中，选择用户，然后从用户列表中选择您的 IAM 用户。

在用户详细信息页面上，选择 Security Credentials 选项卡，然后选择 Upload SSH public key。

将 SSH 公有密钥的内容粘贴到该字段中，然后选择 Upload SSH public key。

复制或保存 SSH Key ID 中的信息 (例如，APKAEIBAERJR2EXAMPLE)。

在本地计算机上，使用文本编辑器在 ~/.ssh 目录中创建一个配置文件，然后向该文件中添加以下行，其中 User 的值是您之前复制的 SSH 密钥 ID：

Host git-codecommit.*.amazonaws.com.cn
  User APKAEIBAERJR2EXAMPLE
  IdentityFile ~/.ssh/codecommit_rsa

将该文件命名为 config 并保存。

在终端中，运行下面的命令更改配置文件的权限：

chmod 600 config

运行下面的命令测试您的 SSH 配置：

ssh git-codecommit.cn-north-1.amazonaws.com.cn

系统会要求您确认连接，因为 git-codecommit.cn-north-1.amazonaws.com.cn 尚未包含在您的已知主机文件中。CodeCommit 服务器指纹作为验证的一部分显示（适用于 MD5 的 11:7e:2d:74:9e:3b:94:a2:69:14:75:6f:5e:22:3b:b3 或适用于 SHA256 的 IYUXxH2OpTDsyYMLIp+JY8CTLS4UX+ZC5JVZXPRaxc8）。

确认连接后，您应会看到已将服务器添加到已知主机文件的确认消息和成功连接消息。如果未看到成功消息，请仔细检查您是否已将 config 文件保存到为访问 CodeCommit 而配置的 IAM 用户的 ~/.ssh 目录中，以及您是否指定了正确的私有密钥文件。

如需获取帮助您排查问题的信息，请运行 ssh 命令并指定 -v 参数：例如：

ssh -v git-codecommit.cn-north-1.amazonaws.com.cn

有关可帮助您解决连接问题的信息，请参阅 SSH 与 Amazon CodeCommit 的连接问题排查。

打开 CodeCommit 控制台：https://console.aws.amazon.com/codesuite/codecommit/home。

在区域选择器中，选择创建存储库的 Amazon Web Services 区域。存储库特定于 Amazon Web Services 区域。有关更多信息，请参阅区域和 Git 连接端点。

从列表中找到您要连接的存储库并选择此存储库。选择 Clone URL (克隆 URL)，然后选择克隆或连接到存储库时要使用的协议。此时将复制克隆 URL。

打开 终端。在 /tmp 目录中，使用您复制的 SSH URL，运行 git clone 命令以克隆存储库。例如，要将名为 MyDemoRepo 的存储库克隆到中国（北京）区域中名为 my-demo-repo 的存储库，请运行以下命令：

git clone git-codecommit.cn-north-1.amazonaws.com.cn/v1/repos/MyDemoRepo my-demo-repo

git clone ssh://Your-SSH-Key-ID@git-codecommit.cn-north-1.amazonaws.com.cn/v1/repos/MyDemoRepo my-demo-repo

有关如何连接存储库的更多信息，请参阅通过克隆 CodeCommit 存储库来连接存储库。