Armazenar pacotes Conda no Artifact Registry

Neste guia de início rápido, mostramos como configurar um repositório privado do Artifact Registry Conda e fazer upload de um pacote para ele.

Antes de começar

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Cloud de Confiance project.

  3. Enable the Artifact Registry API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  4. Make sure that you have the following role or roles on the project: Artifact Registry Administrator

    Check for the roles

    1. In the Cloud de Confiance console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Cloud de Confiance console, go to the IAM page.

      Go to IAM
    2. Select the project.
    3. Click Grant access.

    4. In the New principals field, enter your user identifier. This is typically the identifier for a user in a workforce identity pool. For details, see Represent workforce pool users in IAM policies, or contact your administrator.

    5. Click Select a role, then search for the role.
    6. To grant additional roles, click Add another role and add each additional role.
    7. Click Save.
  5. Para usar a CLI do Conda no seu ambiente Cloud de Confiance , instale um dos seguintes gerenciadores de pacotes do Conda:

Iniciar o Cloud Shell

Neste guia de início rápido, você vai usar o Cloud Shell, que é um ambiente shell para gerenciar recursos hospedados noCloud de Confiance by S3NS.

O Cloud Shell vem pré-instalado com a Google Cloud CLI e o Conda. A CLI gcloud fornece a principal interface de linha de comando para Cloud de Confiance.

Inicie o Cloud Shell

  1. Acesse o console do Cloud de Confiance .

    Cloud de Confiance console

  2. Na barra de ferramentas do console do Cloud de Confiance , clique em Ativar o Cloud Shell.

Uma sessão do Cloud Shell é aberta dentro de um quadro inferior no console. Use esse shell para executar comandos gcloud.

Configurar a autenticação

Um canal do Conda é o endereço de um local onde um ou mais pacotes do Conda são armazenados. Antes de instalar pacotes no seu ambiente Conda, adicione o canal do pacote ao arquivo de configuração do Conda.

Para permitir que a CLI do Conda chame o Artifact Registry diretamente, autentique seu canal do Conda no Cloud de Confiance by S3NS fazendo o seguinte:

  1. Na CLI gcloud, execute o comando a seguir para armazenar a identidade de um token oauth em uma variável TOKEN:

    export TOKEN="oauth2accesstoken:$(gcloud auth print-access-token)"

  2. Adicione seu repositório do Conda como um canal no arquivo de configuração do Conda:

    Conda

    conda config --add channels \
https://$TOKEN@LOCATION-conda.pkg.dev/PROJECT/REPOSITORY

    Miniforge

    conda config --add channels \
https://$TOKEN@LOCATION-conda.pkg.dev/PROJECT/REPOSITORY

    Mamba

    mamba config --add channels \
https://$TOKEN@LOCATION-conda.pkg.dev/PROJECT/REPOSITORY

    Micromamba

    micromamba config --add channels \
https://$TOKEN@LOCATION-conda.pkg.dev/PROJECT/REPOSITORY

    Em que:

    • TOKEN armazena o valor do token oauth gerado ao executar oauth2accesstoken:$(gcloud auth print-access-token).
    • LOCATION é o local regional ou multirregional do repositório.
    • PROJECT é o ID do projeto que contém o repositório.
    • REPOSITORY é o ID do repositório.

Atualizar um token oauth expirado

Um token oauth expira após uma hora. Para autenticar seu canal com um novo token, faça o seguinte:

  1. Remova o canal do arquivo de configuração:

    Conda

    conda config --remove channels CHANNEL_NAME

    Miniforge

    conda config --remove channels CHANNEL_NAME

    Mamba

    mamba config --remove channels CHANNEL_NAME

    Micromamba

    micromamba config --remove channels CHANNEL_NAME

  2. Siga a etapa anterior, que descreve como criar um novo token oauth.

  3. Adicione o repositório do Conda de volta ao arquivo de configuração do Conda usando o novo valor do token.

Criar um repositório

Crie o repositório para seu pacote.

  1. Execute o seguinte comando para criar um novo repositório Conda no projeto atual chamado quickstart-conda-repo no local us-west1.

    gcloud artifacts repositories create quickstart-conda-repo \
    --repository-format=conda \
    --location=us-west1 \
    --description="Conda repository"

  2. Execute o seguinte comando para verificar se o repositório foi criado:

    gcloud artifacts repositories list

  3. Para simplificar os comandos gcloud, defina o repositório padrão como quickstart-conda-repo e o local padrão como us-west1. Depois que os valores forem definidos, não será necessário especificá-los nos comandos gcloud que exigem um repositório ou local.

    Para definir o repositório, execute o comando:

    gcloud config set artifacts/repository quickstart-conda-repo

    Para definir o local, execute o seguinte comando:

    gcloud config set artifacts/location us-west1

    Saiba mais sobre esses comandos na documentação do gcloud config set.

Fazer upload do pacote para o repositório

Para fazer upload de um pacote para o repositório, execute o seguinte comando:

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 fazer upload de 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.

Ver o pacote no repositório

Para verificar se o pacote foi adicionado, liste os pacotes no repositório quickstart-conda-repo.

Execute este comando:

gcloud artifacts packages list --repository=quickstart-conda-repo

Para ver as versões de um pacote, execute o seguinte comando:

gcloud artifacts versions list --package=PACKAGE_NAME

Para conferir os arquivos de uma versão do pacote, execute o seguinte comando:

gcloud artifacts files list --package=PACKAGE_NAME --version=VERSION

Instale o pacote

Para instalar o pacote que você acabou de adicionar ao repositório do Artifact Registry, execute o seguinte comando:

Conda

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

Miniforge

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

Mamba

mamba install -n ENVIRONMENT_NAME PACKAGE_NAME

Micromamba

micromamba install -n ENVIRONMENT_NAME PACKAGE_NAME

Em que:

  • ENVIRONMENT_NAME é o nome do seu ambiente Conda.
  • PACKAGE_NAME é o nome do pacote a ser instalado no repositório.

Solução de problemas

Consulte Solução de problemas para pacotes do Conda para mais informações.

Limpar

Para evitar cobranças na conta do Cloud de Confiance pelos recursos usados nesta página, siga as etapas abaixo.

Antes de remover o repositório, verifique se os pacotes que você quer manter estão disponíveis em outro local.

  1. Para excluir o repositório quickstart-conda-repo, execute o seguinte comando:

    gcloud artifacts repositories delete quickstart-conda-repo

  2. Se você quiser remover as configurações padrão de repositório e localização que definiu para a configuração ativa gcloud, execute os seguintes comandos:

    gcloud config unset artifacts/repository
gcloud config unset artifacts/location

A seguir