管理 Conda 套件

在 Artifact Registry 中建立 Conda 存放區後，即可在新存放區中安裝 Conda 套件。本頁說明如何安裝、查看及刪除 Conda 套件。

事前準備

1. 安裝並初始化 Google Cloud CLI。

   如要執行 Conda 存放區的指令，必須使用 Google Cloud CLI 354.0.0 版或更新版本。您可以使用下列指令查看版本：

   gcloud version
   

2. 如要在 Cloud de Confiance 環境中使用 Conda CLI，請安裝下列其中一個 Conda 套件管理工具：

   • Conda
   • Mamba
   • Micromamba
   • Miniforge

3. 如果 Artifact Registry 中沒有 Conda 存放區，請建立 Conda 套件存放區。

4. (選用) 設定 gcloud 指令的預設值。

Artifact Registry 支援標準和遠端的 Conda 存放區。您可以使用下列任一地址做為遠端存放區。

• https://repo.anaconda.com/pkgs/main
• https://repo.anaconda.com/pkgs/r
• https://repo.anaconda.com/pkgs/msys2
• https://conda.anaconda.org/conda-forge
• https://conda.anaconda.org/bioconda

必要的角色

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

• 查看套件或套件中的檔案： Artifact Registry 讀取者 (roles/artifactregistry.reader)
• 下載或安裝套件： Artifact Registry 讀取者 (roles/artifactregistry.reader)
• 將套件新增至存放區： Artifact Registry 寫入者 (roles/artifactregistry.writer)
• 刪除套件： Artifact Registry 存放區管理員 (roles/artifactregistry.repoAdmin)

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

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

管理 Conda 套件

將 Conda 套件新增至 Artifact Registry 存放區後，您可以使用 Cloud de Confiance將套件安裝至 Conda 環境，並查看套件的詳細資料。

將套件新增至 Artifact Registry 存放區

如要將 Conda 套件新增至 Artifact Registry 存放區，請執行下列指令：

gcloud artifacts files upload \
    --source=PACKAGE_NAME \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

其中：

• REPO_NAME 是存放區的 ID。
• PROJECT 是包含存放區的專案 ID。
• LOCATION 是存放區的區域或多區域位置。

如要一次新增多個套件，請按照下列步驟操作：

gcloud artifacts files upload \
    --source-directory=DIRECTORY \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

其中：

• DIRECTORY 是包含 Conda 套件的本機資料夾地址。

安裝套件

存放區模式：標準、遠端

如要在 Conda 環境中安裝套件的最新穩定版本，請執行下列指令：

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

mamba install -n ENVIRONMENT_NAME PACKAGE_NAME

micromamba install -n ENVIRONMENT_NAME PACKAGE_NAME

其中：

• ENVIRONMENT_NAME 是 Conda 環境的名稱。 如果您已啟用環境，並直接在環境中安裝套件，可以省略 -n ENVIRONMENT_NAME。

• PACKAGE_NAME 是 Conda 套件的名稱。

  如要在 Conda 環境中安裝特定版本的套件，請在套件名稱後方加入 VERSION。

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

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

查看套件和版本

存放區模式：標準、遠端

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

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

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

如果是遠端存放區，傳回的清單只會顯示已快取的套件。

列出檔案

存放區模式：標準、遠端

如果是遠端存放區，傳回的清單只會顯示快取的 Conda 套件和索引檔案。

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

對於下列所有指令，您可以在指令中加入 --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：您的 Cloud de Confiance by S3NS 專案 ID。
• REPOSITORY：儲存映像檔的存放區名稱。
• PACKAGE：套件名稱。
• VERSION：套件版本。

範例

請參考下列套件資訊：

• 專案：my-project
• 存放區：my-repo
• 存放區位置：u-france-east1
• 套件：my-app

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

gcloud artifacts files list \
    --location=u-france-east1 \
    --repository=my-repo

gcloud artifacts files list \
    --project=my-project \
    --location=u-france-east1 \
    --repository=my-repo \
    --package=my-app \
    --version=1.0

刪除套件和版本

存放區模式：標準、遠端

您可以刪除套件和所有版本，也可以刪除特定版本。 刪除的套件無法還原。

刪除套件或套件版本前，請確認您已傳達或解決所有重要的依附元件。

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

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

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

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

如果是遠端存放區，Artifact Registry 會刪除所選套件的快取資料，包括套件版本和檔案。

後續步驟

• 瞭解如何管理容器映像檔