Armazene pacotes Apt no Artifact Registry

Antes de começar

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

   Go to project selector

2. Verify that billing is enabled for your Trusted Cloud project.

3. Enable the Artifact Registry API.

   Enable the API

Instale a CLI gcloud

1. Instale e inicialize a CLI Google Cloud se ainda não estiver instalada. Para uma instalação existente, atualize os componentes da CLI gcloud com o comando:

   gcloud components update
   

   Para verificar a sua versão da CLI gcloud, execute o comando:

   gcloud version
   

Crie um repositório

Crie o repositório para os seus artefactos.

1. Crie o repositório:

   Consola

   1. Abra a página Repositórios na Trusted Cloud consola.

      Abra 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 formato.

   5. Em Tipo de localização, selecione Região e, de seguida, escolha a localização u-france-east1.

   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 repositório Apt no projeto atual com o nome quickstart-apt-repo na localização u-france-east1.

      gcloud artifacts repositories create quickstart-apt-repo \
          --repository-format=apt \
          --location=u-france-east1 \
          --description="Apt repository"
      

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

      gcloud artifacts repositories list
      

Já pode adicionar um pacote ao repositório.

Adicione um pacote ao repositório

Pode carregar um pacote para um repositório através da CLI Google Cloud ou importar um pacote armazenado no Cloud Storage.

Para este início rápido, carrega um ficheiro de exemplo através do comando gcloud artifacts apt upload.

1. No Cloud Shell, transfira a folha de referência rápida do Apt com o comando:

   apt download apt-dpkg-ref
   

   O Apt transfere a versão mais recente do pacote disponível nos repositórios Apt configurados.

   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 obter o nome do ficheiro da folha de referência rápida do Apt. O nome do ficheiro é semelhante a apt-dpkg-ref_5.3.1+nmu2_all.deb.

2. Para simplificar os comandos gcloud, defina o repositório predefinido como quickstart-apt-repo e a localização predefinida como u-france-east1. Depois de definir os valores, não precisa de os especificar em gcloud comandos que requerem um repositório ou uma localização.

   Para definir o repositório, execute o comando:

   gcloud config set artifacts/repository quickstart-apt-repo
   

   Para definir a localização, execute o comando:

   gcloud config set artifacts/location u-france-east1
   

   Para mais informações sobre estes comandos, consulte a documentação gcloud config set.

3. Execute o comando gcloud artifacts apt upload para carregar o pacote para o repositório:

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

   Substitua FILE_NAME pelo caminho para a folha de referência rápida do Apt.

Veja o pacote no repositório

Confirme se o pacote foi adicionado ao repositório.

Consola

1. Abra a página Repositórios na Trusted Cloud consola.

   Abra a página Repositórios

2. Na lista de repositórios, clique no repositório quickstart-apt-repo.

   A página Pacotes apresenta os pacotes no repositório.

gcloud

Para apresentar uma lista dos pacotes no repositório quickstart-apt-repo, execute o comando:

 gcloud artifacts packages list

Para ver as versões de um pacote no quickstart-apt-repo, execute o comando:

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

Crie uma VM

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

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

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

Por predefinição, a VM não tem os âmbitos de acesso necessários para trabalhar com o repositório. O sinalizador --scopes define o âmbito de acesso da VM como cloud-platform.

Configure o gestor de pacotes

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

1. Aceda à página de instâncias de VM.

   Abra a página de instâncias de VM

2. Na linha com a sua VM, clique em SSH. É aberta uma nova janela com uma sessão de terminal na VM.

3. Execute gcloud init para inicializar a CLI gcloud na sua VM.

4. Atualizar apartamento:

   sudo apt update
   

5. Instale o auxiliar de credenciais do Apt na VM para permitir que o Apt faça a autenticação:

   sudo apt install apt-transport-artifact-registry
   

6. Configure a VM para aceder aos pacotes do Artifact Registry:

   echo 'deb ar+https://u-france-east1-apt.s3nsregistry.fr/projects/PROJECT quickstart-apt-repo main' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list
   

   Substitua PROJECT pelo seu Trusted Cloud by S3NS ID do projeto.

Instale o pacote

Instale o pacote que 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 devolvidas têm o seguinte aspeto:

   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) ...
   

Limpar

Para evitar incorrer em cobranças na sua Trusted Cloud conta pelos recursos usados nesta página, siga estes passos.

Antes de remover o repositório, certifique-se de que todos os pacotes que quer manter estão disponíveis noutra localização.

Para eliminar o repositório:

Consola

1. Abra a página Repositórios na Trusted Cloud consola.

   Abra a página Repositórios

2. Na lista de repositórios, selecione o repositório quickstart-apt-repo.

3. Clique em Eliminar.

gcloud

1. Para eliminar o repositório quickstart-apt-repo, execute o seguinte comando:

   gcloud artifacts repositories delete quickstart-apt-repo
   

2. Se quiser remover as predefinições do repositório e da localização que configurou para a configuração gcloud ativa, execute os seguintes comandos:

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

Para eliminar a VM que criou, execute o seguinte comando:

gcloud compute instances delete quickstart-apt-vm

O que se segue?

• Saiba como trabalhar com pacotes DEB.
• Leia sobre o DevOps e explore o programa de investigação de DevOps.