GSP1131

總覽

Artifact Registry 是一項安全、可擴充的全代管服務，適合用來儲存、管理及保護構件和依附元件。本實驗室會引導您建立私人 Docker 存放區、設定驗證機制，以及推送和提取範例 Docker 映像檔。在實作的過程中，您可以初步瞭解如何將 Artifact Registry 用於容器化應用程式。

目標

在本實驗室，您將瞭解如何執行下列工作：

• 在 Artifact Registry 建立私人 Docker 存放區
• 設定驗證機制
• 將映像檔推送至存放區
• 從存放區提取映像檔

先備知識

進行本實驗室前，建議您先累積一些 Docker 的使用經驗。如要複習或瞭解相關概念，歡迎參閱 Docker 說明文件。您也可以參加「Docker 簡介」實驗室，進行更多實作練習！

設定和需求

瞭解以下事項後，再點選「Start Lab」按鈕

請詳閱以下操作說明。實驗室活動會計時，且中途無法暫停。點選「Start Lab」後就會開始計時，顯示可使用 Google Cloud 資源的時間。

您將在真正的雲端環境完成實作實驗室活動，而不是模擬或示範環境。為此，我們會提供新的暫時憑證，供您在實驗室活動期間登入及存取 Google Cloud。

為了順利完成這個實驗室，請先確認：

• 可以使用標準的網際網路瀏覽器 (Chrome 瀏覽器為佳)。

注意事項：請使用無痕模式 (建議選項) 或私密瀏覽視窗執行此實驗室，這可以防止個人帳戶和學員帳戶之間的衝突，避免個人帳戶產生額外費用。

• 是時候完成實驗室活動了！別忘了，活動一旦開始將無法暫停。

注意事項：務必使用實驗室專用的學員帳戶。如果使用其他 Google Cloud 帳戶，可能會產生額外費用。

如何開始研究室及登入 Google Cloud 控制台

1. 點選「Start Lab」按鈕。如果實驗室會產生費用，畫面上會出現選擇付款方式的對話方塊。左側的「Lab Details」窗格會顯示下列項目：

   • 「Open Google Cloud console」按鈕
   • 剩餘時間
   • 必須在這個研究室中使用的臨時憑證
   • 完成這個實驗室所需的其他資訊 (如有)

2. 點選「Open Google Cloud console」；如果使用 Chrome 瀏覽器，也能按一下滑鼠右鍵，選取「在無痕視窗中開啟連結」。

   接著，實驗室會啟動相關資源，並開啟另一個分頁，顯示「登入」頁面。

   提示：您可以在不同的視窗中並排開啟分頁。

   注意：如果頁面中顯示「選擇帳戶」對話方塊，請點選「使用其他帳戶」。

3. 如有必要，請將下方的 Username 貼到「登入」對話方塊。

   {{{user_0.username | "Username"}}}

   您也可以在「Lab Details」窗格找到 Username。

4. 點選「下一步」。

5. 複製下方的 Password，並貼到「歡迎使用」對話方塊。

   {{{user_0.password | "Password"}}}

   您也可以在「Lab Details」窗格找到 Password。

6. 點選「下一步」。

   重要事項：請務必使用實驗室提供的憑證，而非自己的 Google Cloud 帳戶憑證。 注意：如果使用自己的 Google Cloud 帳戶來進行這個實驗室，可能會產生額外費用。

7. 按過後續的所有頁面：

   • 接受條款及細則。
   • 由於這是臨時帳戶，請勿新增救援選項或雙重驗證機制。
   • 請勿申請免費試用。

Google Cloud 控制台稍後會在這個分頁開啟。

注意：如要使用 Google Cloud 產品和服務，請點選「導覽選單」，或在「搜尋」欄位輸入服務或產品名稱。

啟動 Cloud Shell

Cloud Shell 是搭載多項開發工具的虛擬機器，提供永久的 5 GB 主目錄，而且在 Google Cloud 中運作。Cloud Shell 提供指令列存取權，方便您使用 Google Cloud 資源。

1. 點按 Google Cloud 控制台頂端的「啟用 Cloud Shell」圖示 。

2. 系統顯示視窗時，請按照下列步驟操作：

   • 繼續操作 Cloud Shell 視窗。
   • 授權 Cloud Shell 使用您的憑證發出 Google Cloud API 呼叫。

連線建立完成即代表已通過驗證，而且專案已設為您的 Project_ID：。輸出內容中有一行文字，宣告本工作階段的 Project_ID：

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud 是 Google Cloud 的指令列工具，已預先安裝於 Cloud Shell，並支援 Tab 鍵自動完成功能。

3. (選用) 您可以執行下列指令來列出使用中的帳戶：

gcloud auth list

4. 點按「授權」。

輸出內容：

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (選用) 您可以使用下列指令來列出專案 ID：

gcloud config list project

輸出內容：

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} 注意：如需 gcloud 的完整說明，請前往 Google Cloud 參閱 gcloud CLI 總覽指南。

工作 1：建立 Docker 存放區

在這個部分，您將在 Artifact Registry 建立私人 Docker 存放區，方便集中儲存及管理 Docker 映像檔。您需要使用 gcloud 指令列工具建立存放區，然後透過 Google Cloud 控制台確認是否建立成功。

1. 點選控制台右上角的 圖示，開啟新的 Cloud Shell 視窗。

2. 執行下列指令取得專案 ID，並將該 ID 儲存為環境變數：

export PROJECT_ID=$(gcloud config get-value project)

3. 執行下列指令，在 區域建立新的 Docker 存放區 example-docker-repo，然後在說明部分輸入「Docker repository」(Docker 存放區)：

gcloud artifacts repositories create example-docker-repo --repository-format=docker \ --location={{{project_0.default_region | Region}}} --description="Docker repository" \ --project=$PROJECT_ID

4. 執行下列指令來確認存放區已建立完成：

gcloud artifacts repositories list \ --project=$PROJECT_ID

5. 在控制台頂端的搜尋列輸入 Artifact Registry，然後選取第一筆搜尋結果。

6. 在「Artifact Registry」產品頁面，確認您可以看到剛才建立的存放區，畫面應如下所示：

7. 點選 example-docker-repo 存放區後，您應該會發現該存放區沒有任何檔案。在接下來的幾個部分，我們會引導您將檔案新增至存放區。

您也可以在「Artifact Registry」產品頁面，點選「建立存放區」按鈕，並按照上述步驟操作。

點選「Check my progress」，確認目標已達成。 建立 Docker 存放區

工作 2：為 Artifact Registry 設定驗證機制

如要在新建立的 Docker 存放區推送和提取映像檔，必須設定 Docker 來向 Artifact Registry 進行驗證 (包括設定憑證)，確保 Docker 用戶端能安全與存放區互動。

推送或提取映像檔前，請先設定 Docker，透過 Google Cloud CLI 驗證傳送至 Artifact Registry 的要求。

1. 執行下列指令，為 區域中的 Docker 存放區設定驗證機制：

gcloud auth configure-docker {{{project_0.default_region | Region}}}-docker.pkg.dev

這項指令會更新 Docker 設定，現在您可以在 Google Cloud 專案連結 Artifact Registry，開始推送及提取映像檔。

如要瞭解其他驗證方式，請參閱驗證方式的相關說明。

工作 3：取得要推送的映像檔

本實驗室需要用到 Docker 映像檔，但您不必從零開始，可以直接從公開存放區提取預建的範例映像檔，這樣就能專心學習如何與 Artifact Registry 互動。

在本實驗室，您將推送名為 hello-app 的範例映像檔。

1. 執行下列指令，提取映像檔的 1.0 版。

docker pull us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0

Artifact Registry 的映像檔路徑包含多個部分，下方以這個範例映像檔為例：

• us-docker.pkg.dev：儲存在 Artifact Registry Docker 存放區的容器映像檔主機名稱，其中 us 代表存放區位置。
• google-samples：專案 ID。
• containers：存放區 ID。
• /gke/hello-app：映像檔在存放區 containers 的路徑。

工作 4：將映像檔新增至存放區

接下來，您需要將範例映像檔新增至私人存放區。整個過程中，必須使用存放區名稱標記映像檔來指定目的地，然後將映像檔推送至 Artifact Registry。

請務必先完成標記步驟，再推送 Docker 映像檔。

使用儲存庫名稱標記映像檔

請為映像檔加上標記，確保系統將映像檔推送至正確的位置。在本實驗室，推送目的地為 -docker.pkg.dev。

1. 執行下列指令，將映像檔標記為 sample-image:tag1：

docker tag us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0 \ {{{project_0.default_region | Region}}}-docker.pkg.dev/$PROJECT_ID/example-docker-repo/sample-image:tag1

在這項指令中：

• ：存放區位置。
• -docker.pkg.dev：新建 Docker 存放區的主機名稱。
• $PROJECT_ID：Google Cloud 專案 ID。
• example-docker-repo：新建存放區的 ID。
• sample-image：要在存放區使用的映像檔名稱，可以使用和本機映像檔不同的名稱。在本實驗室，您會將映像檔直接儲存在 ID 為 example-docker-repo 的存放區。
• tag1：要為 Docker 映像檔加上的標記。如未指定，Docker 會套用預設標記 latest。

現在可以開始將映像檔推送至新建的存放區了！

將映像檔推送至 Artifact Registry

設定驗證機制並標記本機映像檔後，即可將映像檔推送至您建立的存放區。

請執行下列指令來推送 Docker 映像檔：

docker push {{{project_0.default_region | Region}}}-docker.pkg.dev/$PROJECT_ID/example-docker-repo/sample-image:tag1

點選「Check my progress」，確認目標已達成。 將映像檔新增至存放區。

工作 5：從 Artifact Registry 提取映像檔

最後，您需要提取剛才推送至私人存放區的映像檔。這項練習活動會模擬實際情境，有助於瞭解如何存取及使用儲存在 Artifact Registry 的映像檔。

1. 執行下列指令，將 Artifact Registry 中的映像檔提取至本機電腦：

docker pull {{{project_0.default_region | Region}}}-docker.pkg.dev/$PROJECT_ID/example-docker-repo/sample-image:tag1

輸出結果應該會類似下列內容：

latest: Pulling from [PROJECT-ID]/sample-image:tag1 Digest: sha256:70c42... Status: Image is up to date for {{{project_0.default_region | Region}}}-docker.pkg.dev/$PROJECT_ID/example-docker-repo/sample-image:tag1

恭喜！

實驗室活動期間，您成功在 Artifact Registry 建立私人 Docker 存放區、設定驗證機制、將範例映像檔推送至存放區，並將映像檔提取回本機。現在，您已初步瞭解如何使用 Artifact Registry 管理 Docker 映像檔。

後續步驟/瞭解詳情

• 查看 Artifact Registry 說明文件
• 進一步瞭解 Docker
• 前往 Google Cloud Skills Boost 瀏覽其他實驗室

Google Cloud 教育訓練與認證

協助您瞭解如何充分運用 Google Cloud 的技術。我們的課程會介紹專業技能和最佳做法，讓您可以快速掌握要領並持續進修。我們提供從基本到進階等級的訓練課程，並有隨選、線上和虛擬課程等選項，方便您抽空參加。認證可協助您驗證及證明自己在 Google Cloud 技術方面的技能和專業知識。

使用手冊上次更新日期：2024 年 11 月 28 日

實驗室上次測試日期：2024 年 11 月 28 日

Copyright 2025 Google LLC 保留所有權利。Google 和 Google 標誌是 Google LLC 的商標，其他公司和產品名稱則有可能是其關聯公司的商標。