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

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

# 如何從 CodeCatalyst 遷移
<a name="migration"></a>

*在仔細考慮之後，我們決定關閉新客戶對 Amazon CodeCatalyst 的存取權，自 2025 年 11 月 7 日開始生效。現有的 Amazon CodeCatalyst 客戶可以繼續使用具有現有空間的服務，但無法建立新的空間。 AWS 會繼續投資 Amazon CodeCatalyst 的安全性和可用性，但我們不打算推出新功能。*

 客戶可以手動將資料從 Amazon CodeCatalyst 遷移到其他供應商。本文件說明從 CodeCatalyst AWS 和管理主控台遷移、擷取或刪除資料的基本方法。透過 CodeCatalyst 主控台在其他 AWS 或 3P 服務中建立的資源和資料將需要透過這些服務刪除，以停止累積費用 （如適用）。

客戶可以考慮[使用 Amazon Q 遷移至 GitLab Duo，Amazon Q ](https://aws.amazon.com/blogs/devops/announcing-general-availability-of-gitlab-duo-with-amazon-q/)已於 2025 年 4 月 17 日宣布正式上市。這個新產品是整合產品，結合了 [GitLab 的](https://about.gitlab.com/) DevSecOps 平台與 Amazon Q 的生成式 AI 功能。搭配 Amazon Q 的 Gitlab Duo 會將 Amazon Q 代理程式功能直接嵌入 GitLab 的 DevSecOps 平台，以在整個軟體開發生命週期中加速複雜的多步驟任務。

## 遷移您的儲存庫
<a name="w2aac11b9"></a>

### 將 CodeCatalyst 儲存庫遷移至 GitLab 儲存庫
<a name="w2aac11b9b3"></a>

使用先決條件 URL 搭配 HTTPS Git 儲存庫登入資料，請遵循 GitLab 文件中有關[透過 URL 從儲存庫](https://docs.gitlab.com/ee/user/project/import/repo_by_url.html)[匯入原始碼](https://docs.gitlab.com/ee/user/project/import/)的指引。

### 將 CodeCatalyst 儲存庫遷移至 GitHub 儲存庫
<a name="w2aac11b9b5"></a>

使用先決條件 URL 搭配 HTTPS Git 儲存庫登入資料，請遵循 GitHub 文件中有關[匯入原始碼](https://docs.github.com/en/migrations/importing-source-code/using-github-importer/about-github-importer)的指引。

### 一般遷移到不同的儲存庫供應商
<a name="w2aac11b9b7"></a>

1. **複製 CodeCatalyst 儲存庫**

   使用 Git 將 Amazon CodeCatalyst 儲存庫複製到本機電腦。如果您使用的是 HTTPS，您可以執行下列命令來執行此操作：

   ```
   git clone --mirror https://your-aws-repository-url your-aws-repository
   ```

   `your-aws-repository-url` 以 Amazon CodeCatalyst 儲存庫的 URL 取代 。

    `your-aws-repository` 使用此儲存庫的名稱取代 。

    範例：

   ```
   git clone https://git-codecatalyst.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
   ```

1. **設定新的遠端儲存庫指標**

   導覽至您複製的 Amazon CodeCatalyst 儲存庫的目錄。然後，從新的儲存庫提供者新增儲存庫 URL 做為遠端：

   ```
   git remote add <provider name> <provider-repository-url>
   ```

   `<provider name>` 將 取代為您選擇的提供者名稱。（範例：gitlab)

    使用新儲存庫供應商儲存庫的 URL 取代 <provider-repository-url>。

1. **將本機儲存庫推送至新的遠端儲存庫：**

   這會將所有分支和標籤推送到新的儲存庫提供者的儲存庫。供應商名稱必須符合步驟 2 中的供應商名稱。

   ```
   git push <provider name> --mirror
   ```

   備註：
   + 遠端儲存庫應該是空的
   + 視提供者而定，遠端儲存庫可能會有不允許強制推送的受保護分支。如果發生這種情況，您必須導覽至新的儲存庫提供者，並停用分支保護，以允許強制推送。

1. **驗證遷移**

   推送完成後，請確認所有檔案、分支和標籤都已成功遷移至新的儲存庫提供者。您可以透過線上瀏覽儲存庫，或將其複製到另一個位置並在本機檢查，來執行此操作。

1. ****更新遠端 URLs（選用）****

   如果您打算在本機繼續使用遷移的儲存庫，建議您更新遠端 URL，以指向新供應商的儲存庫，而不是 Amazon CodeCatalyst。您可使用下列命令來執行此作業：

   ```
   git remote set-url origin <provider-repository-url>
   ```

   使用新儲存庫供應商儲存庫的 URL 取代 <provider-repository-url>。

## 從 CodeCatalyst 擷取您的資料
<a name="w2aac11c11"></a>

### 下載成品
<a name="w2aac11c11b3"></a>

您可以下載並檢查 Amazon CodeCatalyst 工作流程動作所產生的成品。您可以下載兩種類型的成品：
+ 來源成品 – 包含來源儲存庫內容快照的成品，其在執行開始時就存在。
+ 工作流程成品 – 在工作流程組態檔案的 Outputs 屬性中定義的成品。

若要下載工作流程輸出的成品：

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

1. 選擇您的專案。

1. 在導覽窗格中，選擇 **CI/CD**，然後選擇**工作流程**。

1. 選擇工作流程的名稱。您可以依定義工作流程的來源儲存庫或分支名稱進行篩選，或依工作流程名稱或狀態進行篩選。

1. 在工作流程的名稱下，選擇**執行**。

1. 在**執行歷史記錄**的**執行 ID** 欄中，選擇執行。例如，Run-95a4d。

1. 在執行的名稱下，選擇**成品**。

1. 在成品旁，選擇**下載**。將下載封存檔案。其檔案名稱由七個隨機字元組成。

1. 使用您選擇的封存擷取公用程式來擷取封存。

### 下載您的問題附件
<a name="w2aac11c11b5"></a>

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

1. 選擇您要管理附件的問題。如需尋找問題的協助，請參閱[尋找和檢視問題 ](https://docs.aws.amazon.com/codecatalyst/latest/userguide/issues-view.html)

1. 若要下載附件，請選擇您要下載之附件旁的省略符號功能表，然後選擇**下載**。

### 下載動作的原始程式碼
<a name="w2aac11c11b7"></a>

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

1. 選擇您的專案。

1. 尋找您要檢視其程式碼的動作：

   1. 在導覽窗格中，選擇 **CI/CD**，然後選擇**工作流程**。

   1. 選擇任何工作流程的名稱，或建立一個。如需建立工作流程的資訊，請參閱[建立工作流程](https://docs.aws.amazon.com/codecatalyst/latest/userguide/workflows-create-workflow.html)。

   1. 選擇**編輯**。

   1. 在左上角，選擇 **\$1 動作**以開啟動作目錄。

   1. 在下拉式清單中，選擇 **Amazon CodeCatalyst** 以檢視 CodeCatalyst、CodeCatalyst 實驗室和第三方動作。

   1. 搜尋動作，然後選擇其名稱。請勿選擇加號 (**\$1**)。

    動作的詳細資訊隨即出現。

1. 在動作詳細資訊對話方塊中，靠近底部，選擇**下載**。

   隨即出現頁面，顯示動作原始碼所在的 Amazon S3 儲存貯體。如需 Amazon S3 的相關資訊，請參閱《Amazon *Simple Storage Service *[使用者指南》中的什麼是 Amazon S3？](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)。

## 從 CodeCatalyst 刪除您的資料
<a name="w2aac11c13"></a>

從 CodeCatalyst 刪除您的資料之前，請通知您的團隊服務遷移，並驗證不需要任何資源。一旦刪除資料和資源，就無法復原。

### 請求服務團隊代表您刪除資料
<a name="w2aac11c13b5"></a>

空間管理員可以透過 CodeCatalyst 主控台中的支援中心聯絡我們，請求服務團隊代刪除空間。空間管理員必須在 CodeCatalyst 主控台中驗證，才能請求刪除空間。提交請求後，服務團隊會先聯絡您確認請求，再代表您採取行動。

### 刪除 CodeCatalyst 空間
<a name="w2aac11c13b7"></a>

您可以刪除空間，以移除所有空間資源的存取權。您必須具有**空間管理員**角色才能刪除空間。

**注意：**您無法復原空間刪除，而且一旦空間刪除，就無法擷取資料。****

刪除空間後，所有空間成員都將無法存取空間資源。空間資源的計費也會停止，而第三方來源儲存庫提示的任何工作流程也會停止。

如果您屬於多個空格，請選擇頂端導覽列中的空格。

**刪除空格**

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

1. 導覽至您的空間。
**提示**  
如果您屬於多個空格，請在頂端導覽列中選擇空格。

1. 選擇**設定**，然後選擇**刪除**。

1. 輸入 **delete** 以確認刪除。

1. 選擇 **刪除**。
**注意**  
如果您屬於多個空間，系統會將您重新導向至空間概觀頁面。如果您屬於一個空間，系統會將您重新導向至空間建立頁面。

如果您刪除空間，但屬於多個空間，系統會將您重新導向至空間概觀頁面。如果您屬於一個空間，系統會將您重新導向至空間建立頁面。

如果您從 CodeCatalyst 主控台在其他 AWS 或第三方服務中建立資源，您將需要個別前往這些服務，以從其建立的帳單帳戶關閉資源。刪除空間只會刪除 CodeCatalyst 資料和資源。

### 刪除專案
<a name="w2aac11c13b9"></a>

您可以刪除專案，以移除對專案資源的所有存取權。您必須擁有**空間管理員**或**專案管理員**角色，才能刪除專案。刪除專案後，專案成員將無法存取專案資源，而且第三方來源儲存庫提示的任何工作流程都將停止。

若要刪除您的專案：

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

1. 使用您要檢視的專案導覽至空間。在**專案**下，選擇您的專案。

1. 在導覽窗格中，選擇**專案設定**。

1. 選擇**刪除專案**。

1. 輸入 **delete** 以確認刪除。

1. 選擇**刪除專案**。

如果您在 CodeCatalyst 專案的其他 AWS 或第三方服務中建立資源，則需要個別前往這些服務，以從其建立的帳單帳戶中關閉資源。刪除空間只會刪除 CodeCatalyst 資料和資源。

### 刪除來源儲存庫
<a name="w2aac11c13c11"></a>

您可以刪除 Amazon CodeCatalyst 專案的來源儲存庫。刪除來源儲存庫也會刪除儲存在儲存庫中的任何專案資訊。如果任何工作流程依賴於來源儲存庫，則在刪除儲存庫之後，這些工作流程將從專案工作流程清單中刪除。不會刪除或修改參考來源儲存庫的問題，但新增至問題之來源儲存庫的任何連結都會在刪除儲存庫後失敗。

*重要：*****刪除來源儲存庫無法復原。刪除來源儲存庫之後，您就無法再複製來源儲存庫、從中提取資料，或將資料推送至來源儲存庫。刪除來源儲存庫不會刪除該儲存庫的任何本機複本 （本機儲存庫）。若要刪除本機儲存庫，請使用本機電腦的目錄和檔案管理工具。****

*注意：*****您無法在 CodeCatalyst 主控台中刪除連結的儲存庫。若要刪除連結的儲存庫，請選擇儲存庫清單中的連結，以在託管儲存庫的 服務中開啟該儲存庫，然後刪除它。如需詳細資訊，請參閱託管連結儲存庫之服務的文件。****

若要從專案中移除連結的儲存庫，請參閱 [ CodeCatalyst 中的取消連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](https://docs.aws.amazon.com/codecatalyst/latest/userguide/extensions-unlink.html)。

**刪除來源儲存庫**

1. 導覽至包含您要刪除之來源儲存庫的專案。

1. 在專案的摘要頁面上，從清單中選擇您想要的儲存庫，然後選擇**檢視儲存庫**。或者，在導覽窗格中，選擇**程式碼**，然後選擇**來源儲存庫**。從專案的來源儲存庫清單中選擇儲存庫的名稱。

1. 在儲存庫的首頁上，選擇**更多**，選擇**管理設定**，然後選擇**刪除儲存庫**。

1. 檢閱分支、提取請求和相關工作流程資訊，以協助確保您不會刪除仍在使用中或未完成工作的儲存庫。如果您想要繼續，請輸入**刪除**，然後選擇**刪除**。

### 刪除自訂藍圖
<a name="w2aac11c13c13"></a>

當您從 Amazon CodeCatalyst 空間刪除藍圖時，系統會移除對藍圖專案或藍圖版本資源的所有存取權。當您刪除藍圖時，專案成員將無法存取專案資源，而且第三方來源儲存庫提示的任何工作流程都將停止。

如果您刪除藍圖，不會影響已套用藍圖的專案。藍圖的資源不會從專案中移除。

*重要：*若要從空間中刪除已發佈的自訂藍圖或自訂藍圖的目錄版本，您必須使用空間中具有 Space 管理員或 Power 使用者角色的帳戶登入。

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

1. 在 CodeCatalyst 主控台中，導覽至您要刪除自訂藍圖的空間。

1. 在空間儀表板上，選擇**設定**索引標籤，然後選擇**藍圖**。

1. 在**設定**資料表上，選擇您要刪除之自訂藍圖的選項按鈕，然後選擇**刪除藍圖**。

1. 輸入 `delete` 以確認刪除藍圖目錄版本。

1. 選擇 **刪除**。

### 刪除您的問題附件
<a name="w2aac11c13c15"></a>

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

1. 選擇您要管理附件的問題。如需尋找問題的協助，請參閱[尋找和檢視問題。 ](https://docs.aws.amazon.com/codecatalyst/latest/userguide/issues-view.html)

1. 若要移除附件，請選擇您要移除之附件旁的省略符號功能表，然後選擇**刪除**。

### 在透過 Amazon CodeCatalyst 存取的開發環境中刪除檔案
<a name="w2aac11c13c17"></a>

您可以在開發環境中、本機電腦或整合式開發環境 (IDE) 中刪除檔案。您無法刪除 Amazon CodeCatalyst 主控台中的檔案。

### 刪除您空間的開發環境
<a name="w2aac11c13c19"></a>

如需刪除開發環境考量的詳細資訊，請參閱[刪除開發環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-delete.html)。

您必須擁有**空間管理員**角色才能檢視此頁面，以及在空間層級管理開發環境。如果您屬於多個空格，請在頂端導覽列中選擇空格。

**刪除開發環境**

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

1. 導覽至 CodeCatalyst 空間

1. 選擇**設定**，然後選擇**開發環境**。

1. 選擇您要管理之開發環境旁的選擇器。選擇 **刪除**。

1. 輸入 **delete** 以確認開發環境刪除。

1. 選擇 **刪除**。

### 刪除帳戶連線
<a name="w2aac11c13c21"></a>

您可以在先前新增至空間的 CodeCatalyst 主控台中刪除帳戶連線。刪除帳戶連線後，您無法重新連線，而且必須建立新的連線。

必須為您的 CodeCatalyst 空間指定帳單帳戶，即使該空間的使用量不超過 免費方案。您必須先為空間新增另一個帳戶，才能移除指定帳單帳戶之帳戶的空間。如果您想要刪除空間的帳單帳戶，則需要刪除空間。請參閱《Amazon CodeCatalyst 管理員指南》中的[管理帳單](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html)。

若要管理空間的帳戶連線，您必須擁有 **Space 管理員**或 **Power 使用者**角色。

稍後可以再次新增已移除的帳戶，但您必須在帳戶與空間之間建立新的連線。您將需要重新建立任何 IAM 角色與帳戶的關聯。

**刪除帳戶連線**

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

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

1. 在 **Amazon CodeCatalyst 顯示名稱**下，選擇您要移除的帳戶連線旁的選擇器。

1. 選擇**移除 AWS 帳戶**。在欄位中輸入名稱以確認刪除，然後選擇**移除**。

   隨即顯示成功橫幅，並從連線清單中移除帳戶連線。

### 從 AWS 管理主控台中的 CodeCatalyst 空間移除帳戶
<a name="w2aac11c13c23"></a>

您可以使用 中的 CodeCatalyst 頁面 AWS 來移除已新增至空格的帳戶。針對此程序，使用您管理之特定帳戶的管理許可，登入 AWS 管理主控台中的 Amazon CodeCatalyst Spaces 頁面，從您的空間中移除 AWS 帳戶。若要移除屬於 CodeCatalyst 空間指定帳單帳戶的帳戶，請務必先指定新的帳單帳戶。

稍後可以再次新增已移除的帳戶，但您必須在帳戶與空間之間建立新的連線。您需要重新建立任何 IAM 角色與新增帳戶的關聯。

必須為您的 CodeCatalyst 空間指定帳單帳戶，即使該空間的使用量不超過 免費方案。您必須先為空間新增另一個帳戶，才能移除指定帳單帳戶之帳戶的空間。

您必須擁有 **Space 管理員**或 **Power 使用者**角色，才能管理空間的帳戶連線。

**移除新增的帳戶**

1. 在 中 AWS 管理主控台，請確定您使用要管理的相同帳戶登入。

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

1. 導覽至 CodeCatalyst 空間。選擇**設定**，然後選擇**帳單**。

1. 檢視頁面上的帳單帳戶資訊，以確定您要移除的帳戶不是空間的指定帳單帳戶。

1. 選擇**管理帳單 AWS**。這會在 中開啟 Amazon CodeCatalyst Spaces AWS 管理主控台。如果系統提示您登入，請登入 AWS，然後再次選擇 按鈕以載入頁面。

1. 在 **Amazon CodeCatalyst Spaces** 頁面上，選擇包含您要移除之帳戶的空間。空間的詳細資訊頁面隨即顯示。

1. 選擇**移除空間**。

1. 在**從此帳戶移除 CodeCatalyst 空間**中，輸入要確認的空間名稱。選擇**移除**。

### 刪除秘密
<a name="w2aac11c13c25"></a>

使用下列程序刪除秘密和秘密參考識別符。刪除秘密之前，建議您從所有工作流程動作中移除秘密的參考識別碼。如果您刪除秘密但不刪除參考識別符，則下次執行動作時將會失敗。

**從工作流程中刪除秘密的參考識別碼**

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

1. 在導覽窗格中，選擇 **CI/CD**，然後選擇**工作流程**。

1. 選擇工作流程的名稱。您可以依定義工作流程的來源儲存庫或分支名稱進行篩選，或依工作流程名稱或狀態進行篩選。

1. 選擇**編輯**。

1. 選擇 **YAML**。

1. 搜尋工作流程以取得下列字串：

   ```
   ${Secrets.
   ```

   這會尋找所有秘密的所有參考識別符。

1. 刪除所選秘密的參考識別符，或將其取代為純文字值。

1. （選用） 選擇**驗證**以在遞交之前驗證工作流程的 YAML 程式碼。

1. 選擇**遞交**，輸入遞交訊息，然後再次選擇**遞交**。

**刪除秘密**

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

1. 在導覽窗格中，選擇 **CI/CD**，然後選擇**秘密**。

1. 在秘密清單中，選擇您要刪除的秘密。

1. 選擇 **刪除**。

1. 輸入 **delete** 以確認刪除。

1. 選擇 **刪除**。

### 刪除團隊
<a name="w2aac11c13c27"></a>

您可以刪除不再需要的團隊。當您刪除團隊時，將從空間中的所有專案和資源中移除所有團隊成員的相關聯許可。您必須擁有 **Space 管理員**角色才能管理團隊。

**刪除團隊**

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

1. 導覽至您的空間。選擇**設定**，然後選擇**團隊**。

1. 在**動作**中，選擇**刪除團隊**。這會變更整個團隊的角色。

1. 選擇 **刪除**。

### 刪除佈建的機群
<a name="w2aac11c13c29"></a>

使用下列指示來刪除佈建的機群。

刪除佈建機群之前，請先從動作的 YAML 程式碼中刪除機群屬性，將其從所有動作中移除。刪除佈建機群之後繼續參考的任何動作，都會在下次動作執行時失敗。

**刪除佈建的機群**

1. 在導覽窗格中，選擇 **CI/CD**，然後選擇**運算**。

1. 在**佈建機群**清單中，選擇您要刪除的機群。

1. 選擇 **刪除**。

1. 輸入 **delete** 以確認刪除。

1. 選擇 **刪除**。

### 刪除套件儲存庫
<a name="w2aac11c13c31"></a>

執行下列步驟以刪除 CodeCatalyst 中的套件儲存庫。

**刪除套件儲存庫**

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

1. 導覽至包含您要刪除之套件儲存庫的專案。

1. 從導覽窗格中，選擇**套件**。

1. 在**套件儲存庫**頁面上，選擇您要刪除的儲存庫。

1. 選擇 **刪除**。

1. 檢閱有關刪除套件儲存庫效果的資訊。

1. 在輸入欄位中輸入 `delete` ，然後選擇**刪除**。

刪除空間時，Amazon CodeCatalyst 中存放的所有其他資源都會遭到刪除。這不包括透過 CodeCatalyst 主控台在其他 AWS 或 3P 服務中建立的資源和資料。在 CodeCatalyst 主控台外的服務中建立的所有資源都需要透過這些服務刪除，才能停止產生費用。

如果您有其他問題，請透過 aws-codecatalyst-service@amazon.com 聯絡我們，或透過 Amazon CodeCatalyst 主控台中的支援中心聯絡我們。