管理 Java 套件

本頁面說明如何新增、查看及刪除 Java 套件。

如果您想使用 sbt 做為 Scala 和 Java 的建構工具，而非使用 Maven 或 Gradle，則可使用社群建立的 sbt 外掛程式。本文件不會說明 Scala 用戶端的設定或用法。

事前準備

  1. 如果目標存放區不存在，請建立新的存放區。
  2. 確認您具備存放區所需的權限。
  3. 確認您已設定驗證。如果您使用存取權存證，請務必先重新整理權杖，再連線至存放區。
  4. (選用) 設定 gcloud 指令的預設值。

必要的角色

如要取得管理套件所需的權限，請要求管理員為您授予存放區的下列 IAM 角色：

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

您或許還可透過自訂角色或其他預先定義的角色取得必要權限。

新增套件

存放區模式：標準

如要將套件新增至存放區，請按照下列步驟操作：

Maven

使用 mvn deploy 和 mvn release 將套件新增至存放區。

如要順利部署參照父項的 Maven 專案，專案必須在核心擴充功能檔案中加入 Artifact Registry Wagon 供應器，如驗證操作說明所述。

使用 mvn deploy:deploy-file 上傳在 Maven 外建構的構件。

舉例來說，下列範例指令會將 example/external.jar 及其專案檔案 example/pom.xml 部署至存放區 us-central1-maven.pkg.dev/my-project/my-repo

mvn deploy:deploy-file \
-Durl=artifactregistry://us-central1-maven.pkg.dev/my-project/my-repo \
-DpomFile=example/pom.xml -Dfile=example/external.jar

如要設定與 Cloud Build 的整合，請參閱「與 Cloud Build 整合」。

Gradle

如要成功發布至存放區，build.gradle 檔案必須包含 publications 段落，定義要上傳的檔案。

使用 gradle publish 指令將套件上傳至存放區。

查看套件和版本

存放區模式：標準、遠端

如要使用 Google Cloud 控制台或 gcloud 查看套件和套件版本，請按照下列步驟操作：

主控台

  1. 在 Google Cloud 控制台中開啟「Repositories」頁面。

    開啟「存放區」頁面

  2. 在存放區清單中，按一下適當的存放區。

    「Packages」頁面會列出存放區中的套件。

  3. 按一下套件即可查看套件版本。

gcloud

如要列出存放區中的套件，請執行下列指令：

gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]

更改下列內容：

  • REPOSITORY 是存放區的名稱。如果您已設定預設存放區，可以省略此標記來使用預設值。
  • LOCATION 是存放區的地區或多地區位置。 如果您已設定預設位置，則可以省略此標記，以便使用預設值。

如要查看套件的版本，請執行下列指令：

gcloud artifacts versions list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

更改下列內容：

  • PACKAGE 是套件的 ID 或套件的完整 ID。
  • REPOSITORY 是存放區的名稱。如果您已設定預設存放區，則可以略過此標記，以便使用預設值。
  • LOCATION 是存放區的地區或多地區位置。 使用這個旗標可查看特定位置的存放區。如果您已設定預設位置，則可以省略此標記，以便使用預設位置。

對於遠端存放區，傳回的清單應包含所有直接和間接依附元件。

列出檔案

存放區模式：標準、遠端

您可以列出存放區中的檔案、指定套件所有版本中的檔案，或套件特定版本中的檔案。

對於下列所有指令，您可以將 --limit 標記新增至指令，藉此設定要傳回的檔案數量上限。

如要設定預設值時，列出預設專案、存放區和位置中的所有檔案：

gcloud artifacts files list

如要列出指定專案、存放區和位置中的檔案，請執行下列指令：

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

如要列出特定套件的所有版本檔案，請按照下列步驟操作：

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

如要列出特定套件版本的檔案，請按照下列步驟操作：

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

替換下列值：

  • LOCATION：存放區的區域或多區域位置。
  • PROJECT：您的 Google Cloud 專案 ID。如果您的專案 ID 包含冒號 (:)，請參閱網域範圍專案。
  • REPOSITORY：圖片儲存的存放區名稱。
  • PACKAGE：套件名稱。
  • VERSION：套件版本。

範例

請參考以下包裝資訊：

  • 專案：my-project
  • 存放區：my-repo
  • 存放區位置：us-west1
  • 檔案包：my-app

下列指令會列出預設專案中 us-west1 位置的存放區 my-repo 中的所有檔案：

gcloud artifacts files list \
    --location=us-west1 \
    --repository=my-repo
下列指令會列出套件 1.0 版本中的檔案。

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --version=1.0

下載套件

存放區模式：標準、遠端、虛擬

如要將構件中的構件下載為構建的一部分，請將構件宣告為依附元件。

Maven

  1. 在專案 pom.xml 檔案中宣告要下載的套件。以下範例將 artifact 套件的 1.0 版宣告為依附元件。

    <dependencies>
    <dependency>
        <groupId>group</groupId>
        <artifactId>artifact</artifactId>
        <version>1.0</version>
    </dependency>
</dependencies>

    如要進一步瞭解 Maven 依附元件，請參閱 Maven 依附元件簡介和依附元件參考資料。

  2. 建構 Java 專案。

    mvn compile

Gradle

  1. 在專案 build.gradle 檔案中宣告要下載的套件。以下範例將 artifact 套件的 1.0 版宣告為外部編譯依附元件。

    如要進一步瞭解 Gradle 依附元件，請參閱 Gradle 說明文件。

    dependencies {
    compile group: 'group', name: 'artifact', version: '1.0'
}

  2. 建構 Java 專案。

    gradle build

如為標準存放區，您可以直接從存放區下載套件。

對於遠端存放區，您會下載套件及其依附元件的快取副本。如果沒有快取副本，遠端存放區會從上游來源下載套件，並在快取後再提供給您。您可以查看存放區中的套件清單，確認遠端存放區已從上游來源擷取套件。

對於虛擬存放區，Artifact Registry 會在上游存放區中搜尋要求的套件。

  • 如果快取副本不存在，上游遠端存放區會下載並快取要求的套件。虛擬存放區只會提供要求的套件，不會儲存套件。
  • 如果您要求的版本可在多個上游存放區中使用，Artifact Registry 會根據為虛擬存放區設定的優先順序設定，選擇要使用的上游存放區。

舉例來說，假設虛擬存放區針對上游存放區設定了下列優先順序：

  • main-repo：優先順序設為 100
  • secondary-repo1：優先順序設為 80。
  • secondary-repo2：優先順序設為 80。
  • test-repo：優先順序設為 20。

main-repo 的優先順序值最高，因此虛擬存放區一律會優先搜尋該值。

secondary-repo1 和 secondary-repo2 的優先順序都設為 80。如果 main-repo 中沒有要求的套件，Artifact Registry 會接著搜尋這些存放區。由於兩者具有相同的優先順序值，如果兩個存放區都提供該版本，Artifact Registry 可以選擇從任一存放區提供套件。

test-repo 是最低優先順序值，如果其他上游存放區都沒有，則會提供已儲存的構件。

刪除套件和版本

存放區模式：標準、遠端

您可以刪除套件及其所有版本，或刪除特定版本。

  • 刪除套件後即無法復原。
  • 對於遠端存放區，系統只會刪除套件的快取副本。上游來源不受影響。如果您刪除快取的套件，Artifact Registry 會在下次存放區收到相同套件版本的要求時，再次下載並快取該套件。

刪除套件或套件版本前，請確認您已通報或解決其中的任何重要依附元件。

如要刪除套件，請按照下列步驟操作：

主控台

  1. 在 Google Cloud 控制台中開啟「Repositories」頁面。

    開啟「存放區」頁面

  2. 在存放區清單中，按一下適當的存放區。

    「Packages」頁面會列出存放區中的套件。

  3. 選取要刪除的套件。

  4. 按一下 [刪除]。

  5. 在確認對話方塊中，按一下「刪除」。

gcloud

執行下列指令：

gcloud artifacts packages delete PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] [--async]

更改下列內容：

  • PACKAGE 是存放區中的套件名稱。
  • REPOSITORY 是存放區的名稱。如果您已設定預設存放區，可以略過此標記，以便使用預設值。
  • LOCATION 是存放區的地區或多地區位置。 使用這個旗標可查看特定位置的存放區。如果您已設定預設位置，則可以省略此標記，以便使用預設值。

--async 標記會讓指令立即傳回，而不會等待進行中的作業完成。

如要刪除套件版本，請按照下列步驟操作：

主控台

  1. 在 Google Cloud 控制台中開啟「Repositories」頁面。

    開啟「存放區」頁面

  2. 在存放區清單中，按一下適當的存放區。

    「Packages」頁面會列出存放區中的套件。

  3. 按一下套件即可查看該套件的版本。

  4. 選取要刪除的版本。

  5. 按一下 [刪除]。

  6. 在確認對話方塊中，按一下「刪除」。

gcloud

執行下列指令：

gcloud artifacts versions delete VERSION \
    --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] \
    [--async]

更改下列內容：

  • VERSION 是您要刪除的版本名稱。
  • PACKAGE 是存放區中的套件名稱。
  • REPOSITORY 是存放區的名稱。如果您已設定預設存放區，可以略過此標記，以便使用預設值。
  • LOCATION 是存放區的地區或多地區位置。 使用這個旗標可查看特定位置的存放區。如果您已設定預設位置，則可以省略此標記，以便使用預設值。

--async 標記會讓指令立即傳回，而不會等待進行中的作業完成。

後續步驟