Armazenar pacotes Apt no Artifact Registry

Iniciar o Cloud Shell

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

Inicie o Cloud Shell

1. Acesse o Console do Google Cloud.

   Console do Google Cloud

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

Uma sessão do Cloud Shell é aberta dentro de um quadro inferior no console. Você vai usar esse shell para executar os comandos gcloud e criar uma VM e um repositório.

Crie um repositório

Crie o repositório para seus artefatos.

1. Crie o repositório:

   Console

   1. Abra a página Repositórios no console do Google Cloud.

      Abrir a página Repositórios

   2. Clique em Criar repositório.

   3. Especifique quickstart-apt-repo como o nome do repositório.

   4. Selecione Apt como o formato.

   5. Em Tipo de local, selecione Região e escolha o local us-central1.

   6. Clique em Criar.

   O repositório é adicionado à lista de repositórios.

   gcloud

   1. No Cloud Shell, execute o seguinte comando para criar um novo Apt repositório atual com o nome quickstart-apt-repo no local us-central1.

      gcloud artifacts repositories create quickstart-apt-repo \
          --repository-format=apt \
          --location=us-central1 \
          --description="Apt repository"
      

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

      gcloud artifacts repositories list
      

Agora você pode adicionar um pacote ao repositório.

Adicionar um pacote ao repositório

É possível fazer upload de um pacote para um repositório usando a CLI do Google Cloud ou importar um pacote armazenado no Cloud Storage. Se você criar pacotes usando Cloud Build, o build pode armazenar os pacotes no Cloud Storage para você para importar.

Para este guia de início rápido, faça upload de um arquivo de amostra usando o comando gcloud artifacts apt upload.

1. No Cloud Shell, faça o download da planilha de referência rápida do Apt com o comando:

   apt download apt-dpkg-ref
   

   O apt faz o download da versão mais recente do pacote disponível nos repositórios configurados do apt.

   Get:1 http://deb.debian.org/debian buster/main amd64 apt-dpkg-ref all 5.3.1+nmu2 [113 kB]
   Fetched 113 kB in 0s (428 kB/s)
   

   Execute ls para receber o nome do arquivo da planilha de referência rápida do Apt. O nome do arquivo é semelhante a apt-dpkg-ref_5.3.1+nmu2_all.deb.

2. Para simplificar os comandos gcloud, defina o repositório padrão como quickstart-apt-repo e o local padrão como us-central1. 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-apt-repo
   

   Para definir o local, execute o comando:

   gcloud config set artifacts/location us-central1
   

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

3. Execute o gcloud artifacts apt upload para fazer upload do pacote para o repositório:

   gcloud artifacts apt upload quickstart-apt-repo \
       --source=FILE_NAME
   

   Substitua FILE_NAME pelo caminho para o arquivo rápido do Apt. planilha de referência.

Ver o pacote no repositório

Verifique se o pacote foi adicionado ao repositório.

 gcloud artifacts packages list

gcloud artifacts versions list --package=apt-dpkg-ref

Criar uma VM

Crie uma nova VM do Compute Engine para instalar o pacote de exemplo.

No Cloud Shell, execute o seguinte comando para criar uma instância de VM chamada quickstart-apt-vm:

gcloud compute instances create quickstart-apt-vm \
    --image-family=debian-10 \
    --image-project=debian-cloud \
    --scopes=cloud-platform

Por padrão, a VM não tem os escopos de acesso necessários para trabalhando com o repositório. A flag --scopes define o escopo de acesso. da VM para cloud-platform.

Configurar o gerenciador de pacotes

Para instalar um pacote na VM, adicione o repositório criado ao arquivo de configuração do Apt que define os repositórios de pacotes.

1. Acesse a página "Instâncias de VM".

   Abra a página "Instâncias de VM"

2. Na linha da VM, clique em SSH. Uma nova janela é aberta com um terminal na VM.

3. Execute gcloud init para inicializar a Google Cloud CLI na VM.

4. Atualizar apto:

   sudo apt update
   

5. Instale o auxiliar de credenciais do Apt na VM para que ele possa executar autenticação:

   sudo apt install apt-transport-artifact-registry
   

6. Configure a VM para acessar os pacotes do Artifact Registry usando o seguinte comando:

   echo 'deb ar+https://us-central1-apt.pkg.dev/projects/PROJECT quickstart-apt-repo main' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list
   

   Substitua PROJECT pelo ID do projeto do Google Cloud.

Instale o pacote

Instale o pacote que você adicionou ao repositório.

1. Atualize a lista de pacotes disponíveis:

   sudo apt update
   

2. Instale o pacote no seu repositório.

   sudo apt install apt-dpkg-ref/quickstart-apt-repo
   

   As informações de instalação retornadas são semelhantes ao exemplo abaixo:

   Reading package lists... Done
   Building dependency tree
   Reading state information... Done
   Selected version '5.3.1+nmu2' (Debian:10.7/stable, namespaces/my-repo/repositories/quickstart-apt-repo:quickstart
   -apt-repo [all]) for 'apt-dpkg-ref'
   The following NEW packages will be installed:
     apt-dpkg-ref
   0 upgraded, 1 newly installed, 0 to remove and 3 not upgraded.
   Need to get 113 kB of archives.
   After this operation, 128 kB of additional disk space will be used.
   Get:1 http://deb.debian.org/debian buster/main amd64 apt-dpkg-ref all 5.3.1+nmu2 [113 kB]
   Fetched 113 kB in 0s (693 kB/s)
   Selecting previously unselected package apt-dpkg-ref.
   (Reading database ... 39506 files and directories currently installed.)
   Preparing to unpack .../apt-dpkg-ref_5.3.1+nmu2_all.deb ...
   Unpacking apt-dpkg-ref (5.3.1+nmu2) ...
   Setting up apt-dpkg-ref (5.3.1+nmu2) ...