Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定並登入 CodeCatalyst
<a name="setting-up-topnode"></a>

您可以在 CodeCatalyst 中設定兩種空間：支援 AWS 建置器 ID 使用者的空間，以及建立支援聯合身分的空間，其中 SSO 使用者和群組是在 IAM Identity Center 中管理。 AWS 建置器 ID 空間中的使用者使用其 AWS 建置器 ID 登入 CodeCatalyst，以及設定聯合身分登入 CodeCatalyst 的空間中的使用者，請使用與空間相關聯的公司的 SSO 入口網站。

**注意**  
CodeCatalyst 使用者名稱的長度下限為 3，長度上限為 100 個字元。提供超過 100 個字元的使用者名稱將被截斷。這可能會導致使用者名稱看起來與另一個 100 個字元的使用者名稱重複。如需詳細資訊，請參閱[我無法以新使用者身分存取 myBID 空間，或因為使用者名稱被截斷而無法新增為新的 SSO 使用者](troubleshooting.md#troubleshoot-username-truncated)。

本指南提供設定和管理 AWS 建置器 ID 空間的步驟。若要使用 CodeCatalyst AWS Builder ID 空間，您將使用用來登入 CodeCatalyst 的使用者設定和 AWS 建置器 ID 來設定 CodeCatalyst。

*CodeCatalyst 管理員指南*中提供設定和管理支援聯合身分之空間的步驟。若要使用為聯合身分設定的空間，請參閱《Amazon [ CodeCatalyst 管理員指南》中的 CodeCatalyst 空間的設定和管理](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/what-is.html)。 CodeCatalyst 

本節提供兩種常用路徑，用於設定 在具有 AWS 建置器 ID 空間的 Amazon CodeCatalyst 中運作：建立空間和專案做為第一個使用者，並接受現有空間或專案的邀請。這些設定工作流程必須非常不同。下圖顯示兩個註冊程序，如下所示：

1. 在第一個案例中，您會為公司、團隊或群組建立和設定空間，並在邀請其他人使用這些資源之前建立專案。 AWS 帳戶 必須為計費用途提供 ，您仍然可以預設為 免費方案。

1. 在第二個案例中，如果您透過接受專案的邀請來加入 CodeCatalyst，其他人已經為您建立空間和專案。不過，您仍然想要設定您的設定檔，以便準備好開始與他人合作。

![\[註冊並建立您可以邀請成員加入的空間\]](http://docs.aws.amazon.com/zh_tw/codecatalyst/latest/userguide/images/sign-up-types.png)


**提示**  
CodeCatalyst 使用空格來分組專案和資源。當您第一次註冊 CodeCatalyst 時，系統會提示您建立空間和專案。

無論您是註冊以建立空間和專案，或是註冊為接受邀請的一部分，您都會建立用於登入 CodeCatalyst 的 AWS 建置器 ID。若要建立 AWS 建置器 ID，請提供用於登入 AWS 應用程式的完整名稱、密碼和電子郵件地址。之後，您可以使用電子郵件和密碼登入 CodeCatalyst。您也可以使用此 AWS 建置器 ID 來登入使用 AWS 建置器 ID 登入資料的其他應用程式。

在 CodeCatalyst 和 AWS Builder ID 中，會根據您的登入資訊產生*設定檔*。您的設定檔包含 CodeCatalyst 專案中語言和通知設定的 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>

您可以註冊 Amazon CodeCatalyst，而無需邀請現有的空間或專案。當您這麼做時，您會在建立 AWS 建置器 ID 之後建立空間和專案。在建立空間的過程中，您需要新增 AWS 帳戶 以用於計費。

**提示**  
如果您在註冊 Amazon CodeCatalyst 設定檔時遇到任何問題，請遵循該頁面上提供的步驟。如果您需要其他協助，請參閱 [註冊時發生問題](ipa-troubleshooting.md#id-troubleshooting-sign-up)。

以下是從 CodeCatalyst 開始的使用者在沒有專案或空間邀請的情況下的一個可能流程。

Mary Major 是對 CodeCatalyst 感興趣的開發人員，並決定試用它。她導覽至 CodeCatalyst 主控台，並選擇註冊和建立 AWS 建置器 ID 的選項。Mary 提供電子郵件地址和密碼來建立 AWS 建置器 ID。她將能夠使用 AWS Builder ID 登入 CodeCatalyst 和其他應用程式。當要求選擇別名時，她指定 `MaryMajor`為 CodeCatalyst 使用者名稱，該使用者名稱會顯示在 CodeCatalyst 中，而其他專案成員將使用 @mention Mary。

接著，會自動引導 Mary 建立空間。在此流程中，Mary 被要求將 AWS 帳戶 與她建立的空間建立關聯，以便她可以在第一個專案建置和部署中看到範例程式碼。她新增該資訊並建立自己的空間，在其中選擇建立預覽開發角色的選項，可用於新空間中的專案。Mary 選擇建立專案，然後她檢視專案的藍圖清單。檢閱可用藍圖的資訊後，她決定為第一個專案嘗試**現代三層式 Web 應用程式**藍圖。她填寫必要欄位並建立專案。一旦專案準備就緒，她就會進入專案摘要頁面，其中包含最近的活動，以及專案程式碼的連結，以及自動建置和部署該程式碼的工作流程。她探索程式碼和工作流程，包括檢視部署的範例 Web 應用程式。她喜歡看到的內容，決定邀請一些同事參與專案，開始探索 CodeCatalyst。

當她有時間時，Mary 會設定她的 AWS 建置器 ID 以使用多重驗證 (MFA) 登入 CodeCatalyst。設定 MFA 後，Mary 可以使用其 CodeCatalyst 密碼和已核准第三方身分驗證應用程式的密碼或字符的組合來登入 CodeCatalyst。

## 建立新的空間和 IAM 角色
<a name="sign-up-first"></a>

請依照下列步驟註冊 Amazon CodeCatalyst 設定檔、建立空間，以及為您的空間新增 帳戶、支援角色和開發人員角色。

最終程序會建立和新增開發人員角色。開發人員角色是 AWS 可讓 CodeCatalyst 工作流程存取 AWS 資源的 IAM 角色。開發人員角色是用來管理 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 帳戶 ID。如需尋找 AWS 帳戶 ID 的相關資訊，請參閱[您的 AWS 帳戶 ID 及其別名](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html)。

**註冊為新使用者**

1. 在 CodeCatalyst 主控台中開始之前，請開啟 AWS 管理主控台，然後確定您使用您要用來建立空間 AWS 帳戶 的相同 登入。

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 在歡迎頁面上，選擇**註冊**。隨即顯示**建立您的 AWS 建置器 ID** 頁面。您的 AWS 建置器 ID 是您建立用來登入的身分。這與 不同 AWS 帳戶。

1. 在**您的電子郵件地址**中，輸入您要與 CodeCatalyst 建立關聯的電子郵件地址。然後選擇**下一步**。

1. **在您的名稱**中，提供您要在使用該 AWS 建置器 ID 的應用程式中顯示的名字和姓氏。允許空格。這將是您的 AWS 建置器 ID 設定檔名稱，例如 **Mary Major**。您可以稍後變更名稱。

   選擇**下一步**。**電子郵件驗證**頁面隨即顯示。

1. 驗證碼將傳送至您指定的電子郵件。在**驗證碼中輸入此程式碼**，然後選擇**驗證**。如果您在 5 分鐘後未收到程式碼，且無法在垃圾郵件或垃圾郵件資料夾中找到它，請選擇**重新傳送程式碼**。

1. 一旦我們驗證您的程式碼，請輸入符合密碼****和**確認密碼中要求的密碼**。

   選取確認您同意 AWS 客戶協議和 AWS 服務條款的核取方塊，然後選擇**建立 AWS 建置器 ID**。

1. 在**建立 CodeCatalyst 別名**頁面上，輸入您要用於 CodeCatalyst 中唯一使用者識別符的別名。選擇不含空格的簡短名稱版本，例如 **MaryMajor**。其他 CodeCatalyst 使用者將使用它在註解和提取請求中 @mention 您。您的 CodeCatalyst 設定檔將同時包含 AWS 建置器 ID 和 CodeCatalyst 別名的全名。您稍後無法變更 CodeCatalyst 別名。

   您的全名和別名會顯示在 CodeCatalyst 的不同區域中。例如，您的設定檔名稱會顯示在活動摘要中，但專案成員會使用別名來 @mention you。

   選擇**下一步**。頁面會更新以顯示**建立 CodeCatalyst 空間**區段。

1. 在**命名您的空間**中，輸入空間的名稱。您稍後無法變更此項目。
**注意**  
空格名稱在 CodeCatalyst 中必須是唯一的。您無法重複使用已刪除空格的名稱。

1. 在**AWS 區域**下拉式功能表中，選擇您要存放空間和專案資料的區域。您稍後無法變更此項目。

1. 選擇**下一步**。頁面會更新以顯示用於新增 的頁面 AWS 帳戶。此帳戶將用作空間的帳單帳戶。

1. 在 **AWS 帳戶 ID** 中，輸入您要連線到空間之帳戶的 12 位數 ID。

   在**AWS 帳戶驗證字符**中，複製產生的字符 ID。字符會自動為您複製，但您可能想要在核准 AWS 連線請求時將其存放。

1. 選擇**前往 AWS 主控台進行驗證**。

1. **驗證 Amazon CodeCatalyst 空間**頁面會在 中開啟 AWS 管理主控台。這是 **Amazon CodeCatalyst 空格**頁面。您可能需要登入才能存取頁面。

   在 中 AWS 管理主控台，請務必選擇您要建立空間的相同 AWS 區域 。

   若要直接存取頁面，請登入 中的 Amazon CodeCatalyst Spaces， AWS 管理主控台 網址為 https：//https://console.aws.amazon.com/codecatalyst/home/。

   中的驗證字符欄位 AWS 管理主控台 會自動填入 CodeCatalyst 中產生的字符。

1. （選用） 在**已授權付費方案**下，選擇**授權已付費方案 (Standard、Enterprise)** 以開啟帳單帳戶的已付費方案。
**注意**  
這不會將帳單方案升級至付費方案。不過，這會設定 ， 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. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 導覽至 CodeCatalyst 空間。選擇 **Settings (設定)**，然後選擇 **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. 在連線頁面的 ** CodeCatalyst 可用的 IAM 角色**下，檢視新增至您帳戶的 IAM 角色`CodeCatalystWorkflowDevelopmentRole-spaceName`清單中的角色。

1. 若要返回您的空間，請選擇**前往 Amazon CodeCatalyst**。

**建立和新增 CodeCatalyst **AWSRoleForCodeCatalystSupport****

1. 在 CodeCatalyst 主控台中開始之前，請開啟 AWS 管理主控台，然後確定您的 AWS 帳戶 空間使用相同的 登入。

1. 導覽至 CodeCatalyst 空間。選擇 **Settings (設定)**，然後選擇 **AWS 帳戶**。

1. 選擇您要建立角色之 AWS 帳戶 的連結。**AWS 帳戶 詳細資訊**頁面隨即顯示。

1. 選擇**從中管理角色 AWS 管理主控台**。

   在 中開啟**將 IAM 角色新增至 Amazon CodeCatalyst 空間**頁面 AWS 管理主控台。這是 **Amazon CodeCatalyst Spaces** 頁面。您可能需要登入才能存取頁面。

1. 在 **CodeCatalyst 空間詳細資訊**下，選擇**新增 CodeCatalyst Support 角色**。此選項會建立服務角色，其中包含預覽開發角色的許可政策和信任政策。角色會有附加**AWSRoleForCodeCatalystSupport**唯一識別符的名稱。如需角色和角色政策的詳細資訊，請參閱 [了解 **AWSRoleForCodeCatalystSupport** 服務角色](ipa-iam-roles.md#ipa-iam-roles-support-role)。

1. 在**新增 CodeCatalyst Support 角色**頁面上，保持選取預設值，然後選擇**建立角色**。

1. 在 ** CodeCatalyst 可用的 IAM 角色**下，檢視新增至您帳戶的 IAM 角色`CodeCatalystWorkflowDevelopmentRole-spaceName`清單中的角色。

1. 若要返回您的空間，請選擇**前往 Amazon CodeCatalyst**。

建立 AWS 建置器 ID、建立第一個空間並新增帳戶之後，您就可以建立專案。如需詳細資訊，請參閱[建立專案](projects-create.md)。如果這是您第一次使用 CodeCatalyst，我們建議您從 開始[教學課程：使用現代三層 Web 應用程式藍圖建立專案](getting-started-template-project.md)。

# 接受邀請並建立 AWS 建置器 ID
<a name="sign-up-sign-in"></a>

您可以註冊 Amazon CodeCatalyst，作為接受專案或空間邀請的一部分。作為接受邀請的一部分，系統會提示您建立 AWS 建置器 ID。您將使用 AWS 建置器 ID 來存取 CodeCatalyst 中的資源。

**提示**  
如果您需要其他說明，請參閱 [註冊時發生問題](ipa-troubleshooting.md#id-troubleshooting-sign-up)。

以下是使用者從 CodeCatalyst 開始的可能流程，其中包含專案或空間的邀請。

Saanvi Sarkar 是開發人員，他收到以專案管理員身分加入 CodeCatalyst 專案的邀請。Saanvi 接受邀請，這會開啟 CodeCatalyst 的登入頁面。她選擇註冊並提供電子郵件地址和密碼來建立 AWS 建置器 ID。Saanvi 將可以使用其 AWS 建置器 ID 登入 CodeCatalyst 和其他應用程式。稍後，她可以編輯設定檔來變更登入電子郵件地址或密碼。當系統要求選擇別名時，Saanvi 會將 指定`SaanviSarkar`為 CodeCatalyst 別名，該別名會顯示在 CodeCatalyst 中，而其他專案成員將使用 @mention Saanvi。註冊之後，Saanvi 也可以將她的登入憑證用於使用 AWS 建置器 ID 憑證的其他應用程式。

註冊完成後，Saanvi 會自動加入邀請中指定的 CodeCatalyst 專案和空間。邀請也會為她在專案和空間中的角色提供預先決定的許可。在專案設定中，Saanvi 的別名會顯示在成員清單中，其中包含她指派的專案角色。若要在 CodeCatalyst 中使用來源儲存庫，Saanvi 需要一些時間來建立個人存取字符 (PAT)。在進行來源變更或需要身分驗證字符的動作時，PAT 將用於 CodeCatalyst 進行身分驗證。

當 Saanvi 在專案上工作時，她的別名會列在專案的工作活動日誌中。Saanvi 的問題和評論會顯示她的別名，其他專案成員可以在回應中 @mention her。若要 @mention 另一個專案成員，Saanvi 會在 CodeCatalyst 設定檔上查詢其別名。

當她有時間時，Saanvi 會設定其 AWS 建置器 ID 以使用多重驗證 (MFA) 登入 CodeCatalyst。設定 MFA 後，Saanvi 可以使用其 CodeCatalyst 密碼和已核准第三方身分驗證應用程式的密碼或字符的組合登入 CodeCatalyst。

## 接受邀請並建立 AWS 建置器 ID
<a name="id-how-to"></a>

當您受邀加入 Amazon 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 建置器 ID 設定檔名稱，例如 **Mary Major**。您可以稍後變更名稱。

   選擇**下一步**。

   驗證碼將傳送至您指定的電子郵件。在**驗證碼中輸入此程式碼**，然後選擇**驗證**。如果您在 5 分鐘後未收到程式碼，且無法在垃圾郵件或垃圾郵件資料夾中找到它，請選擇**重新傳送程式碼**。

1. 驗證您的程式碼後，請輸入符合密碼****和**確認密碼中要求的密碼**。

1. 選擇**建立 AWS 建置器 ID**。

1. 在**建立別名**頁面上，輸入您要用於 CodeCatalyst 中唯一使用者識別符的別名。選擇不含空格的簡短名稱版本，例如 **MaryMajor**。其他 CodeCatalyst 使用者將使用此功能，在註解和提取請求中 @mention 您。CodeCatalyst 設定檔將同時包含 AWS 建置器 ID 和 CodeCatalyst 別名的全名。您無法變更 CodeCatalyst 別名。

   您的全名和別名會顯示在 CodeCatalyst 的不同區域中。例如，您的設定檔名稱會顯示在活動摘要中，但專案成員會使用別名來 @mention you。

   選擇**建立別名**。系統會帶您前往獲邀請的專案或空間。

# 使用 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. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 輸入**您的電子郵件地址**。或者，如果您想要**儲存電子郵件地址**以供日後登入，請選擇儲存我的電子郵件地址。選擇**繼續**。

1. 輸入**您的密碼**。選擇 **Sign In (登入)**。如果您不記得密碼，請遵循中的步驟[我忘記密碼](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. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 在**選擇登入選項**下，選擇**使用單一登入 (SSO)**。

1. 在 **AWS Identity Center 應用程式名稱**中，輸入聯合身分管理員提供的應用程式名稱。

1. 選擇**繼續前往 IAM Identity Center**。

# 檢視使用者的所有空間和專案
<a name="home"></a>

您可以在使用者首頁上檢視空間和專案的清單。使用者首頁會顯示使用者所屬的每個空間清單、該空間中使用者的角色，例如**空間管理員**，以及使用者具有成員資格的每個空間中的專案。

1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 在瀏覽器中，輸入下列地址：https：//[https://codecatalyst.aws/home](https://codecatalyst.aws/home)   
![\[使用者首頁會列出您身為成員的所有空間和專案\]](http://docs.aws.amazon.com/zh_tw/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>

您在註冊時提供資訊，這些資訊將用作登入資料以登入 Amazon CodeCatalyst，並將在您的設定檔中管理。這包括**您的姓名**、**暱稱**，以及您用來登入 CodeCatalyst **的電子郵件地址**。

**注意**  
 AWS Builder ID **別名**不是您的 CodeCatalyst 別名。您已在註冊時選取 CodeCatalyst 別名。

**檢視 CodeCatalyst 設定檔**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 在右上角，選擇具有第一個首字母圖示旁的箭頭，然後選擇**我的設定**。CodeCatalyst **我的設定**頁面隨即開啟。

1. 若要更新您的 AWS 建置器 ID 電子郵件地址或密碼，或設定 MFA，請選擇**管理 AWS 建置器 ID**。 AWS 建置器 ID 頁面隨即開啟。

## 檢視其他使用者的 CodeCatalyst 設定檔
<a name="view-another-user-profile"></a>

**檢視其他使用者的 CodeCatalyst 設定檔**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 在側邊導覽上，選擇**專案設定**。選擇**成員**索引標籤。檢視 CodeCatalyst 專案的成員清單。

1. 選擇您要查詢的成員名稱或 @mention。**我的設定**頁面會顯示使用者的別名、電子郵件地址和全名。使用 CodeCatalyst 別名給 @mention 專案成員。
**注意**  
使用者的 AWS 建置器 ID **別名**不是其 CodeCatalyst 別名。他們在註冊時選擇了 CodeCatalyst 別名。

   若要在專案中檢視其他使用者的設定檔，請在清單中選擇其名稱。

# 更新設定檔
<a name="your-profile"></a>

在 CodeCatalyst 中，您的設定檔包含由**AWS 建置器 ID** 管理的個人資訊，以及 CodeCatalyst 中管理的設定。
+ 您設定檔的全名、電子郵件地址和密碼是由 **AWS Builder ID** 管理。您在註冊時輸入此資訊。當您設定 MFA 以使用驗證器應用程式登入應用程式時，CodeCatalyst 會帶您前往**AWS 建置器 ID** 頁面。
+ 您的個人存取字符 (PAT)、CodeCatalyst 通知和語言偏好設定的 CodeCatalyst 設定會在 CodeCatalyst 的**我的設定**頁面中管理。 CodeCatalyst 如需詳細資訊，請參閱[使用個人存取權杖授予使用者儲存庫存取權](ipa-tokens-keys.md)。

**注意**  
您可以更新您的 AWS 建置器 ID 全名 (CodeCatalyst 顯示名稱） 和名字。不過，您無法變更 CodeCatalyst 別名。

## 更新 AWS 建置器 ID 或電子郵件地址
<a name="id-update-profile"></a>

**更新您的 AWS 建構家 ID 或 電子郵件地址**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

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. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 在右上角，選擇具有第一個首字母圖示旁的箭頭，然後選擇**使用者設定檔**。CodeCatalyst **我的設定**頁面隨即開啟。

1. 在設定檔頁面上，選擇**管理 AWS 建置器 ID**。 AWS 建置器 ID 頁面隨即開啟。

1. 在頁面左側，選擇**安全性**。

1. 選擇**變更密碼**，然後依照指示操作。

# 設定 以 AWS CLI 搭配 CodeCatalyst 使用
<a name="set-up-cli"></a>

Amazon CodeCatalyst 主控台是您處理大部分日常任務的地方。不過，當您在 CodeCatalyst 中使用開發環境、個人存取字符或事件日誌 AWS CLI 時，建議您設定 。您必須安裝 AWS CLI 並設定設定檔，才能將其與 CodeCatalyst 搭配使用。<a name="how-to-set-up-cli"></a>

# 設定 AWS CLI 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. 如果您沒有設定檔，或想要特別針對 CodeCatalyst 使用具名設定檔，請執行 **aws configure**命令來建立設定檔。我們建議您建立具名設定檔以專門搭配 CodeCatalyst 使用，但您也可以使用預設設定檔。如需詳細資訊，請參閱[組態基本概念](https://docs.aws.amazon.com//cli/latest/userguide/cli-configure-quickstart.html)。

1. 編輯設定檔的 `config` 檔案，新增區段以連線至 CodeCatalyst，如下所示。`config` 檔案在 Linux 或 macOS 上位於 `~/.aws/config`，在 Windows 上位於 `C:\Users\USERNAME\.aws\config`。

   ```
   [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)