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

# 亚马逊 CodeCatalyst 为带亚马逊 Q 的 Visual Studio 的 Visual Studio Amazon Toolkit
Amazon CodeCatalyst

## 什么是亚马逊 CodeCatalyst？


Amazon CodeCatalyst 是一个面向软件开发团队的基于云的协作空间。使用带有 Amazon Q 的 Visual Studio Amazon 工具包，您可以直接从 Visual Studio 的 Toolkit for Amazon Q 中查看和管理 CodeCatalyst 资源。有关更多信息 CodeCatalyst，请参阅[亚马逊 CodeCatalyst](https://docs.amazonaws.cn/codecatalyst/latest/userguide/welcome.html)用户指南。 Amazon 

以下主题介绍如何将 Visual Studio Amazon 工具包与 Amazon Q 连接起来， CodeCatalyst 以及如何 CodeCatalyst 通过 Visual Studio Amazon 工具包与 Amazon Q 配合使用。

**Topics**
+ [

## 什么是亚马逊 CodeCatalyst？
](#codecatalyst-intro)
+ [入门 CodeCatalyst](codecatalyst-setup.md)
+ [与 CodeCatalyst](codecatalyst-overview.md)
+ [问题排查](codecatalyst-troubleshoot.md)

# 亚马逊入门 CodeCatalyst 和 Visual Studio 的 Amazon Toolkit for Amazon Q
入门 CodeCatalyst

要开始使用带有 Amazon CodeCatalyst Q 的 Visual Studio Amazon 工具包与亚马逊合作，请完成以下操作。

**Topics**
+ [

## 使用 Amazon Q 安装适用于 Visual Studio 的 Amazon Toolkit
](#codecatalyst-setup-jbgateway)
+ [

## 创建 CodeCatalyst 账号和 Amazon 建筑商 ID
](#codecatalyst-setup-id)
+ [

## 将 Visual Studio 的 Amazon Toolkit 与 Amazon Q 连接起来 CodeCatalyst
](#codecatalyst-setup-connect)

## 使用 Amazon Q 安装适用于 Visual Studio 的 Amazon Toolkit


在将 Visual Studio Amazon 工具包与 Amazon Q 集成到您的 CodeCatalyst账户之前，请确保使用的是最新版本的 Visual Studio Amazon 工具包和 Amazon Q。有关如何使用亚马逊 Q 安装和设置最新版本的 Visual Studio Amazon 工具包的详细信息，请参阅本用户指南的 “使用 Ama [zon Q 为 Visual Studio 设置 Amazon 工具包](https://docs.amazonaws.cn/toolkit-for-visual-studio/latest/user-guide/getting-set-up.html)” 部分。

## 创建 CodeCatalyst 账号和 Amazon 建筑商 ID


除了使用 Amazon Q 安装最新版本的 Visual Studio Visual Studio Amazon 工具包外，您还必须拥有有效的 Amazon 生成器 ID 和 CodeCatalyst 账户才能通过 Amazon Q 与 Visual Studio 的 Amazon Toolkit for Visual Studio 连接。如果您没有有效的 Amazon 生成器 ID 或 CodeCatalyst 账户，请参阅*CodeCatalyst*用户指南中的[设置](https://docs.amazonaws.cn/codecatalyst/latest/userguide/setting-up-topnode.html)方式 CodeCatalyst部分。

**注意**  
 Amazon 生成器 ID 与您的 Amazon 凭证不同。有关如何使用 Amazon 生成器 ID 注册和进行身份验证的说明，请参阅本用户指南中的[身份验证和访问权限： Amazon 生成器 ID](https://docs.amazonaws.cn/toolkit-for-visual-studio/latest/user-guide/builder-id.html) 主题。  
有关 Amazon Builder 的详细信息 IDs，请参阅《*Amazon 通用参考*用户指南》中的 “[Amazon 生成器 ID](https://docs.amazonaws.cn/general/latest/gr/aws_builder_id.html)” 主题。

## 将 Visual Studio 的 Amazon Toolkit 与 Amazon Q 连接起来 CodeCatalyst


要将 Visual Studio 的 Amazon Toolkit for Visual Studio 与 Amazon Q 关联到您的 CodeCatalyst 账户，请完成以下步骤。

1. 在 Visual Studio 的 **Git** 菜单项中，选择**克隆存储库...**。

1. 从 “**浏览存储库**” 部分，选择 **Amazon CodeCatalyst** 作为提供商。

1. 在 “**连接**” 部分中，选择 **Connect w Amazon ith Builder ID**，在首选的 Web 浏览器中打开 CodeCatalyst 控制台。

1. 在浏览器中，在提供的字段中输入您的 Amazon 生成器 ID，然后按照说明继续操作。

1. 出现提示时，选择 “**允许**” 以确认 Visual Studio 的 Amazon Toolkit for Visual Studio 和 Amazon Q 与您的 CodeCatalyst 账户之间的连接。连接过程完成后， CodeCatalyst 会显示一条确认消息，表明可以安全地关闭浏览器。

# 在 Amazon Q 上使用 Visual Studio Amazon 工具包中的亚马逊 CodeCatalyst 资源
与 CodeCatalyst

以下各节概述了带有 Amazon Q 的 Visual Studio 的 Amazon Toolkit for Visual Studio 的可用亚马逊 CodeCatalyst 资源管理功能。

**Topics**
+ [

## 克隆存储库
](#codecatalyst-overview-clone)

## 克隆存储库


CodeCatalyst 是一项基于云的服务，需要您连接到云端才能处理 CodeCatalyst 项目。要在本地处理项目，您可以将 CodeCatalyst 存储库克隆到本地计算机，并在下次连接到云端时与您的 CodeCatalyst 项目同步。

要将存储库克隆到本地计算机，请完成以下步骤。

1. 在 Visual Studio 的 **Git** 菜单项中，选择**克隆存储库...**。

1. 从 “**浏览存储库**” 部分，选择 **Amazon CodeCatalyst** 作为提供商。
**注意**  
如果 “**连接**” 部分显示一条`Not Connected`消息，请先完成本用户指南的 “[身份验证和访问权限： Amazon 生成器 ID](https://docs.amazonaws.cn/toolkit-for-visual-studio/latest/user-guide/builder-id.html)” 部分中的步骤，然后再继续。

1. 选择要从中克隆存储库的**空间**和**项目**。

1. 在**存储库**部分，选择要克隆的存储库。

1. 在**路径**部分，选择要将存储库克隆到的文件夹。
**注意**  
此文件夹最初必须为空才能成功克隆。

1. 选择**克隆**，以开始克隆存储库。

1. 克隆存储库后，Visual Studio 将加载您克隆的解决方案
**注意**  
如果 Visual Studio 未在克隆的存储库中打开解决方案，则可以从**源控制**菜单的 **Git 全局设置**中，通过**打开 Git 存储库时自动加载解决方案**设置调整 Visual Studio 选项。

# 问题排查
问题排查

以下是使用亚马逊 Q 的 Visual Studio For Visual Studio Amazon 工具包解决与亚马逊 CodeCatalyst 合作时已知问题的疑难解答主题。

**Topics**
+ [

## 凭据
](#codecatalyst-troubleshoot-credentials)

## 凭据


如果您在尝试从中克隆基于 git 的存储库时遇到要求提供凭据的对话框 CodeCatalyst，则您的**Amazon CodeCommit 凭据助手**可能会被全局配置，从而造成干扰。 CodeCatalyst有关 Amazon CodeCommit 凭证助手的更多信息，请参阅《*Amazon CodeCommit*用户指南》的 “使用 [Amazon CLI 凭据帮助器在 Windows 上设置与 Windows Amazon CodeCommit 存储库的 HTTPS 连接的步骤](https://docs.amazonaws.cn/codecommit/latest/userguide/setting-up-https-windows.html)” 部分。

要将**Amazon CodeCommit 凭据助手**限制为只能处理 CodeCommit URLs，请完成以下步骤。

1. 打开以下位置的全局 Git 配置文件：`%userprofile%\.gitconfig`

1. 在文件中找到以下部分：

   ```
                           [credential]
                               helper = !aws codecommit credential-helper $@
                               UseHttpPath = true
   ```

1. 将该部分更改为以下内容：

   ```
                           [credential "https://git-codecommit.*.amazonaws.com"]
                               helper = !aws codecommit credential-helper $@
                               UseHttpPath = true
   ```

1. 保存更改，然后完成克隆存储库的步骤。