View a markdown version of this page

連線至原始程式碼 - AWS 轉換
使用 AWS CodeConnections 連線至儲存庫使用個人存取字符連線至儲存庫連線至 Amazon S3 中的原始程式碼

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

連線至原始程式碼

在 之後建立 .NET 現代化任務，在任務計畫索引標籤上， AWS 轉換視窗的左側窗格會列出轉換任務的階段。第一個階段是 Connect 原始程式碼。在此階段中，您會連線到原始程式碼。

開始之前，請確定您的 AWS 帳戶具有建立原始碼連線的許可。視您選擇的連線方法而定，您也需要存取 AWS CodeConnections、存放在 AWS Secrets Manager 中的個人存取字符 (PAT)，或與您的轉換任務位於相同 AWS 區域的 Amazon S3 儲存貯體。建立連接器需要管理員的核准 AWS 。

您可以連線到原始程式碼儲存庫，或在 zip 檔案中提供程式碼。您有 4 個選項可連線至原始碼：

  • 程式碼連線：使用 AWS CodeConnections (GitHub、GitLab、Bitbucket、Azure DevOps) 連線至原始程式碼儲存庫。

  • PAT：使用存放在 AWS Secrets Manager 中的個人存取字符連線至原始碼儲存庫。

  • S3：將 Amazon S3 URI 提供給程式碼封存 zip 檔案 （例如 s3://my-bucket/repos.zip)。

  • 直接上傳：將程式碼封存 zip 檔案拖放到聊天窗格中。

選取程式碼連線方法，代理程式會引導您完成設定。

使用 AWS CodeConnections 連線至儲存庫

如果您選擇程式碼連線選項， AWS 轉換代理程式會使用 AWS CodeConnections 從 Azure Repos、Bitbucket、GitHub 或 GitLab 下載 .NET 程式碼庫。轉換後的程式碼會寫入新的可寫入分支。您必須在與 AWS 轉換任務相同的區域中設定 AWS CodeConnections。

注意

如果您有現有的原始程式碼儲存庫連接器， AWS Transform 會通知您。選取使用現有的連接器來使用此連接器。如果您不想使用現有的連接器，請參閱 刪除現有的連接器 之前的 新增連接器。每個任務只能有一個來源儲存庫連接器。

新增連接器

若要建立新的原始程式碼儲存庫連接器：

  1. 輸入您想要用於 AWS CodeConnections 連接器的 AWS 帳號。

  2. 如果您尚未為相同 AWS 帳戶設定 AWS CodeConnections，請設定 AWS CodeConnections。

  3. 使用AWS 開發人員工具主控台建立 Bitbucket、GitHub、GitHub Enterprise Server、GitLab 或 AzureDevOps 儲存庫的連線。

  4. 複製您所建立連線的 Amazon Resource Name (ARN)。

  5. 返回 AWS 轉換，並貼上您建立之連線的 ARN。

  6. 輸入連接器的名稱。

    注意

    請勿在連接器名稱中輸入個人資訊。

  7. 選取初始化連接器建立。

  8. AWS 轉換會請求在與目前轉換任務相同的區域中，為您輸入的 AWS 帳戶建立連接器，並通知您在 AWS 管理主控台中的 AWS 管理員已準備好核准核准核准請求。選取複製驗證連結。

  9. 如果您是 AWS 管理員，請登入 AWS 帳戶並前往驗證連結以核准連線請求。如果您不是 AWS 管理員，請提供驗證連結給您的 AWS 管理員。

  10. 在 AWS 管理員核准連接器請求後，選取完成連接器以完成連接器建立程序。如果您想要使用不同的連接器，請選取重新啟動，以重新啟動連接器建立程序。

協作索引標籤也包含連接器的詳細資訊，其中包括：

  • 狀態 -- 已核准或待核准

  • AWS 帳戶 ID

  • AWS 區域

  • 連線 ARN

刪除現有的連接器

注意

如果您有現有的原始程式碼儲存庫連接器， AWS Transform 會通知您。選取使用現有連接器或刪除並建立新的連接器。

如果您選擇刪除現有的原始碼儲存庫連線， AWS Transform 會在實際刪除連接器之前警告您。

  1. 您可以用幾種方式刪除現有的連接器：

    1. 如果 AWS 轉換提示您，您可以選取刪除並建立新的連接器。

    2. 您也可以在提示中選取重新啟動。若要修改此連接器，您必須重新啟動。

  2. AWS 轉換會警告您重新啟動將會刪除連接器。若要刪除連接器，請再次選取重新啟動。

  3. AWS 轉換會再次提醒您，刪除連接器會移除與第三方儲存庫的連線，例如 Bitbucket、GitHub 和 GitLab。此外，如果刪除連接器，則使用此連接器的任何 AWS 轉換任務都會失敗。若要確認刪除，請輸入 delete 並選取 Delete。

  4. 若要新增新的原始程式碼儲存庫連接器，請參閱 新增連接器。

使用個人存取字符連線至儲存庫

您可以使用個人存取字符 (PAT) 連線到儲存庫。請遵循下列步驟：

  1. 當客服人員提示輸入原始碼連線時，請在聊天窗格中選擇 PAT。

  2. 閱讀有關產生 PAT 並將其儲存在 AWS Secrets Manager 中的指示。

  3. 從來源控制產生 PAT。

  4. 將您的 PAT 存放在 AWS Secrets Manager 中，並記錄 Amazon Resource Name (ARN)。例如，GitHub 字符的格式如下所示：

    github_pat_XXXXXXXXXXXXXXX

  5. 在聊天中，選擇設定連接器連結以開啟連接器表單。

  6. 在連接器表單中，輸入連接器名稱、 AWS 您的帳戶 ID、秘密 ARN，以及選擇性的 KMS 金鑰 ARN。然後提交表單。

  7. 代理程式提供核准連結。複製連結並傳送給管理員以核准連線。核准後，繼續使用 代理程式。

連線至 Amazon S3 中的原始程式碼

您可以將 AWS Transform 連接到 Amazon S3 中的原始碼，作為連接原始碼儲存庫的替代方案。

S3 儲存貯體組織

原始原始原始程式碼和轉換後的程式碼存放在常見的 S3 儲存貯體中，如下所示。您必須在與 AWS 轉換任務相同的區域中設定 S3 儲存貯體。將原始碼上傳到儲存貯體，做為根層級的 zip 檔案。zip 檔案必須包含每個儲存庫的頂層資料夾。

在轉換期間， AWS Transform 會建立轉換輸出資料夾，並將轉換結果存放在該資料夾中。轉換會建立名為 transformed-code.zip 的 zip 檔案，其中包含轉換後的程式碼。這包括程式碼差異報告檔案名稱 diff.txt，強調專案層級的檔案變更。


<customer-bucket>/
├── source-code.zip
         ├── repo 1
         ├── repo 2
         ├── ......
         ├── repo n            
└── transform-output/
      ├── transformed-code.zip

新增 S3 連接器

若要建立新的 S3 原始碼儲存庫連接器：

  1. 在 AWS 主控台中，建立 S3 儲存貯體。

  2. 將原始碼作為 zip 檔案上傳至 S3 儲存貯體。

  3. 在 AWS 轉換 Web 應用程式中，啟動 .NET 轉換任務。在連接原始碼儲存庫步驟中，選取在 S3 儲存貯體中連接原始碼，然後選擇儲存。

  4. 在下一頁中，輸入您的 S3 儲存貯體詳細資訊，然後選擇提交。

    1. 連接器名稱

    2. AWS 帳戶 ID

    3. S3 儲存貯體 Arn

    4. S3 儲存貯體加密金鑰 （選用）

  5. 核准連接器：

    1. 在下一頁上，複製驗證連結。

    2. 讓核准者瀏覽至連結，以到達 AWS 轉換連接器建立請求頁面。

    3. 選擇 以建立新的角色或使用現有的角色。

    4. 檢閱請求後，選擇儲存並核准以核准請求。

  6. 指定 S3 zip 檔案位置：

    1. 在 AWS 轉換 Web 應用程式中，等待狀態顯示已核准。

    2. 在指定資產位置頁面上，輸入格式為程式碼 zip 檔案的 S3 URL，s3://bucket-name/zip-file-name然後選擇傳送至 AWS 轉換。

    3. 任務會繼續進行探索步驟以繼續轉換。

刪除 S3 連接器

若要刪除現有的 S3 連接器：

  1. 在 AWS 轉換 Web 應用程式中，選取右上角的管理連接器。

  2. 在管理連接器視窗中，選取連接器。

  3. 選擇 刪除。