設定對 GitHub 儲存庫的 Amplify 存取權 - AWS Amplify 託管
為新部署安裝和授權 Amplify GitHub 應用程式將現有OAuth應用程式遷移至 Amplify GitHub 應用程式為 AWS CloudFormation、CLI 和 SDK 部署設定 Amplify GitHub 應用程式使用 Amplify GitHub 應用程式設定 Web 預覽

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

設定對 GitHub 儲存庫的 Amplify 存取權

Amplify 現在使用 GitHub 應用程式功能來授權 Amplify 對 GitHub 儲存庫的唯讀存取。使用 Amplify GitHub 應用程式時，許可會進行更精細的調校，讓您能夠僅將 Amplify 存取權授予您指定的儲存庫。若要進一步了解 GitHub 應用程式，請參閱 GitHub 網站上的關於 GitHub 應用程式。

當您連接存放在 GitHub 儲存庫的新應用程式時，根據預設，Amplify 會使用 GitHub 應用程式來存取儲存庫。不過，您先前從 GitHub 儲存庫連線的現有 Amplify 應用程式會使用 OAuth 進行存取。CI/CD 將繼續適用於這些應用程式，但強烈建議您遷移它們以使用新的 Amplify GitHub 應用程式。

當您使用 Amplify 主控台部署新應用程式或遷移現有應用程式時，系統會自動將您導向 Amplify GitHub 應用程式的安裝位置。若要手動存取應用程式的安裝登陸頁面，請開啟 Web 瀏覽器，然後依區域導覽至應用程式。使用 格式https://github.com/apps/aws-amplify-REGION，將 REGION 取代為您部署 Amplify 應用程式的區域。例如，若要在美國西部 （奧勒岡） 區域安裝 Amplify GitHub 應用程式，請導覽至 https：//https://github.com/apps/aws-amplify-us-west-2。

為新部署安裝和授權 Amplify GitHub 應用程式

當您從 GitHub 儲存庫中的現有程式碼部署新的應用程式至 Amplify 時，請使用下列指示來安裝和授權 GitHub 應用程式。

安裝和授權 Amplify GitHub 應用程式

  1. 登入 AWS Management Console 並開啟 Amplify 主控台。

  2. 從所有應用程式頁面，選擇新增應用程式，然後選擇託管 Web 應用程式。

  3. 在開始使用 Amplify 託管頁面上，選擇 GitHub，然後選擇繼續。

  4. 如果這是第一次連接 GitHub 儲存庫，GitHub.com,請求在您的 GitHub AWS Amplify 帳戶中授權的許可。選擇 Authorize (授權)。

  5. 接著，您必須在 GitHub 帳戶中安裝 Amplify GitHub 應用程式。在 Github.com 上開啟一個頁面，請求在您的 GitHub AWS Amplify 帳戶中安裝和授權的許可。

  6. 選取您要安裝 Amplify GitHub 應用程式的 GitHub 帳戶。

  7. 執行以下任意一項：

    • 若要將安裝套用至所有儲存庫，請選擇所有儲存庫。

    • 若要將安裝限制為您選取的特定儲存庫，請選擇僅選取儲存庫。請務必在您選取的儲存庫中包含您要遷移之應用程式的儲存庫。

  8. 選擇安裝和授權。

  9. 系統會將您重新導向至 Amplify 主控台中應用程式的新增儲存庫分支頁面。

  10. 在最近更新的儲存庫清單中，選取要連線的儲存庫名稱。

  11. 在分支清單中，選取要連線的儲存庫分支名稱。

  12. 選擇下一步。

  13. 在設定建置設定頁面上，選擇下一步。

  14. 在檢閱頁面上，選擇儲存並部署。

將現有OAuth應用程式遷移至 Amplify GitHub 應用程式

您先前從 GitHub 儲存庫連線的現有 Amplify 應用程式會使用 OAuth 進行儲存庫存取。我們強烈建議您遷移這些應用程式以使用 Amplify GitHub 應用程式。

使用下列指示來遷移應用程式，並在 GitHub 帳戶中刪除其對應的 OAuth Webhook。請注意，遷移程序會根據 Amplify GitHub 應用程式是否已安裝而有所不同。遷移第一個應用程式並安裝和授權 GitHub 應用程式後，您只需要更新後續應用程式遷移的儲存庫許可。

將應用程式從 OAuth 遷移至 GitHub 應用程式

  1. 登入 AWS Management Console 並開啟 Amplify 主控台。

  2. 選擇您要遷移的應用程式。

  3. 在應用程式的資訊頁面上，找到藍色遷移至我們的 GitHub 應用程式訊息，然後選擇開始遷移。

  4. 在安裝和授權 GitHub 應用程式頁面上，選擇設定 GitHub 應用程式。

  5. 在 GitHub.com,請求在您的 GitHub AWS Amplify 帳戶中授權的許可。選擇 Authorize (授權)。

  6. 選取您要安裝 Amplify GitHub 應用程式的 GitHub 帳戶。

  7. 執行以下任意一項：

    • 若要將安裝套用至所有儲存庫，請選擇所有儲存庫。

    • 若要將安裝限制為您選取的特定儲存庫，請選擇僅選取儲存庫。請務必在您選取的儲存庫中包含您要遷移之應用程式的儲存庫。

  8. 選擇安裝和授權。

  9. 系統會將您重新導向至 Amplify 主控台中應用程式的安裝和授權 GitHub 應用程式頁面。如果 GitHub 授權成功，您將會看到成功訊息。選擇下一步。

  10. 在完成安裝頁面上，選擇完成安裝。此步驟會刪除您現有的 Webhook、建立新的 Webhook，並完成遷移。

為 AWS CloudFormation、CLI 和 SDK 部署設定 Amplify GitHub 應用程式

您先前從 GitHub 儲存庫連線的現有 Amplify 應用程式會使用 OAuth 進行儲存庫存取。這可能包括您使用 Amplify 命令列界面 (CLI) AWS CloudFormation或 SDKs 部署的應用程式。我們強烈建議您遷移這些應用程式，以使用新的 Amplify GitHub 應用程式。遷移必須在 的 Amplify 主控台中執行 AWS Management Console。如需說明，請參閱將現有OAuth應用程式遷移至 Amplify GitHub 應用程式。

您可以使用 AWS CloudFormation、Amplify CLI 和 SDKs來部署使用 GitHub 應用程式進行儲存庫存取的新 Amplify 應用程式。此程序需要您先在 GitHub 帳戶中安裝 Amplify GitHub 應用程式。接著，您需要在 GitHub 帳戶中產生個人存取字符。最後，部署應用程式並指定個人存取字符。

在您的帳戶中安裝 Amplify GitHub 應用程式

  1. 開啟 Web 瀏覽器，並導覽至您將部署應用程式的 AWS 區域中 Amplify GitHub 應用程式的安裝位置。

    使用 格式https://github.com/apps/aws-amplify-REGION/installations/new，將 REGION 取代為您自己的輸入。例如，如果您在美國西部 （奧勒岡） 區域安裝應用程式，請指定 https://github.com/apps/aws-amplify-us-west-2/installations/new。

  2. 選取您要安裝 Amplify GitHub 應用程式的 GitHub 帳戶。

  3. 執行以下任意一項：

    • 若要將安裝套用至所有儲存庫，請選擇所有儲存庫。

    • 若要將安裝限制為您選取的特定儲存庫，請選擇僅選取儲存庫。請務必在您選取的儲存庫中包含您要遷移之應用程式的儲存庫。

  4. 選擇 Install (安裝)。

在您的 GitHub 帳戶中產生個人存取字符

  1. 登入您的 GitHub 帳戶。

  2. 在右上角，找到您的設定檔相片，然後從功能表中選擇設定。

  3. 在左側導覽功能表中，選擇開發人員設定。

  4. 在 GitHub 應用程式頁面的左側導覽功能表中，選擇個人存取字符。

  5. 在個人存取字符頁面上，選擇產生新字符。

  6. 在新增個人存取字符頁面上，針對備註輸入字符的描述性名稱。

  7. 在選取範圍區段中，選取 admin：repo_hook。

  8. 選擇 Generate token (產生字符)。

  9. 複製並儲存個人存取字符。當您使用 CLI 或 SDKs 部署 Amplify 應用程式時 AWS CloudFormation，您將需要提供它。

在您的 GitHub 帳戶中安裝 Amplify GitHub 應用程式並產生個人存取字符後，您可以使用 Amplify CLI AWS CloudFormation或 SDKs 部署新的應用程式。使用 accessToken 欄位來指定您在先前程序中建立的個人存取字符。如需詳細資訊，請參閱《Amplify API 參考》中的 CreateApp 和AWS CloudFormation 《 使用者指南》中的 AWS::Amplify::App。

下列 CLI 命令會部署新的 Amplify 應用程式，該應用程式使用 GitHub 應用程式進行儲存庫存取。將 myapp-using-githubapp、https://github.com/Myaccount/react-app 和 MY_TOKEN 取代為您自己的資訊。

aws amplify create-app --name myapp-using-githubapp --repository https://github.com/Myaccount/react-app --access-token MY_TOKEN

使用 Amplify GitHub 應用程式設定 Web 預覽

Web 預覽會將對 GitHub 儲存庫提出的每個提取請求 (PR) 部署至唯一的預覽 URL。預覽版現在使用 Amplify GitHub 應用程式來存取您的 GitHub 儲存庫。如需安裝和授權適用於 Web 預覽的 GitHub 應用程式的說明，請參閱 啟用提取請求的 Web 預覽 。