Gerenciar pacotes do Conda

Depois de criar um repositório do Conda no Artifact Registry, você poderá instalar pacotes do Conda no novo repositório. Nesta página, descrevemos como instalar, visualizar e excluir pacotes do Conda.

Antes de começar

1. Instale e inicialize a Google Cloud CLI.

   A Google Cloud CLI versão 354.0.0 ou mais recente é necessária para executar comandos de repositórios do Conda. Para verificar a versão, use o comando:

   gcloud version
   

2. Para usar a CLI do Conda no seu ambiente Cloud de Confiance , instale um dos seguintes gerenciadores de pacotes do Conda:

   • Conda
   • Mamba
   • Micromamba
   • Miniforge

3. Se você não tiver um repositório do Conda no Artifact Registry, crie um repositório de pacotes do Conda.

4. (Opcional) Defina padrões para comandos gcloud.

O Artifact Registry é compatível com repositórios do Conda padrão e remoto. Você pode usar qualquer um dos seguintes endereços para seus repositórios remotos.

• 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

Funções exigidas

Para receber as permissões necessárias para gerenciar pacotes do Conda, peça ao administrador para conceder a você os seguintes papéis do IAM no repositório:

• Ver pacotes ou arquivos em pacotes: Leitor do Artifact Registry (roles/artifactregistry.reader)
• Baixar ou instalar pacotes: Leitor do Artifact Registry (roles/artifactregistry.reader)
• Adicionar pacotes a um repositório: Gravador do Artifact Registry (roles/artifactregistry.writer)
• Excluir pacotes: Administrador do repositório do Artifact Registry (roles/artifactregistry.repoAdmin)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Gerenciar pacotes do Conda

Depois de adicionar um pacote Conda ao seu repositório do Artifact Registry, é possível instalar o pacote no ambiente Conda e conferir detalhes sobre o pacote usando Cloud de Confiance.

Adicionar pacotes a um repositório do Artifact Registry

Para adicionar um pacote do Conda ao repositório do Artifact Registry, execute o comando a seguir:

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

Em que:

• REPO_NAME é o ID do repositório.
• PROJECT é o ID do projeto que contém o repositório.
• LOCATION é o local regional ou multirregional do repositório.

Para adicionar vários pacotes de uma só vez:

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

Em que:

• DIRECTORY é o endereço de uma pasta local que contém seus pacotes do Conda.

Instalar pacotes

Modos de repositório:padrão, remoto

Para instalar a versão estável mais recente de um pacote no seu ambiente Conda, execute o seguinte comando:

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

Em que:

• ENVIRONMENT_NAME é o nome do seu ambiente Conda. Se você já tiver um ambiente ativado e estiver instalando o pacote diretamente nele, deixe de fora -n ENVIRONMENT_NAME.

• PACKAGE_NAME é o nome do seu pacote do Conda.

  Para instalar uma versão específica de um pacote no ambiente conda, inclua VERSION depois do nome do pacote.

No caso de repositórios padrão, você baixa um pacote diretamente do repositório.

Para um repositório remoto, faça o download de uma cópia em cache do pacote e das dependências dele. Se não houver uma cópia em cache, o repositório remoto vai baixar o pacote da origem upstream e armazená-lo em cache antes de disponibilizá-lo para você. Para verificar se o repositório remoto recuperou os pacotes da origem upstream, confira a lista de pacotes no repositório.

Ver pacotes e versões

Modos de repositório:padrão, remoto

Para visualizar pacotes e versões de pacotes usando o Cloud de Confiance console ou gcloud:

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

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

Para repositórios remotos, a lista retornada mostra apenas pacotes armazenados em cache.

Listar arquivos

Modos de repositório:padrão, remoto

Para repositórios remotos, a lista retornada mostra apenas pacotes Conda e arquivos de índice em cache.

É possível listar arquivos em um repositório, em todas as versões de um pacote especificado ou em uma versão específica de um pacote.

Para todos os comandos a seguir, é possível definir um número máximo de arquivos a serem retornados adicionando a flag --limit ao comando.

Para listar todos os arquivos no projeto, repositório e local padrão quando os valores padrão estiverem configurados:

gcloud artifacts files list

Para listar arquivos em um projeto, repositório e local especificados, execute o comando:

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

Para listar arquivos de todas as versões de um pacote específico:

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

Para listar arquivos de uma versão específica do pacote:

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

Substitua os seguintes valores:

• LOCATION: o local regional do repositório.
• PROJECT: o ID do projeto do Cloud de Confiance by S3NS .
• REPOSITORY: o nome do repositório em que a imagem está armazenada.
• PACKAGE: o nome do pacote.
• VERSION: a versão do pacote.

Exemplos

Considere as seguintes informações do pacote:

• Projeto: my-project
• Repositório: my-repo
• Local do repositório: u-france-east1
• Pacote: my-app

O comando a seguir lista todos os arquivos no repositório my-repo no local u-france-east1 dentro do projeto padrão:

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

Excluir pacotes e versões

Modos de repositório:padrão, remoto

É possível excluir um pacote e todas as versões dele ou uma versão específica. Não é possível restaurar pacotes excluídos.

Antes de excluir uma versão de pacote ou um pacote, verifique se você comunicou ou resolveu qualquer dependência importante nele.

Para excluir um pacote:

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

Para excluir versões de um pacote:

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

Para repositórios remotos, o Artifact Registry exclui os dados de cache dos pacotes selecionados, incluindo versões e arquivos.

A seguir

• Saiba mais sobre como gerenciar imagens de contêiner