Guia de início rápido para o Apt

Este guia de início rápido mostra como configurar um repositório Apt do Artifact Registry, adicionar um pacote Debian ao repositório e instalar o pacote.

Você executa as etapas deste guia de início rápido usando o Cloud Shell ou um shell local executado em um sistema operacional baseado em Debian.

Para saber mais sobre como gerenciar pacotes do Debian, consulte Como trabalhar com pacotes do Debian.

Antes de começar

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  4. Ative a API Artifact Registry.

    Ative a API

  5. Instale e inicialize o SDK do Cloud..
  6. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  7. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  8. Ative a API Artifact Registry.

    Ative a API

  9. Instale e inicialize o SDK do Cloud..
  10. Crie uma nova VM na qual você instalará o pacote de amostra. Execute o comando a seguir, substituindo VM_NAME por um nome para a VM.
      gcloud compute instances create VM_NAME \
          --image-family=debian-10 \
          --image-project=debian-cloud \
          --scopes=cloud-platform
  11. Conceda permissões de acesso ao repositório à conta de serviço da sua VM.

Crie um repositório

Crie o repositório dos artefatos.

  1. Crie o repositório:

    Console

    1. Abra a página Repositórios no Console do 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. Execute o seguinte comando para criar um novo repositório Apt no projeto atual chamado 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
      
    3. 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
      

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

Configurar o gerenciador de pacotes

Para instalar um pacote em uma VM, adicione o repositório que você criou ao arquivo de configuração Apt que define os repositórios de pacotes.

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

    Abrir a página Instâncias de VM

  2. Na linha que contém a VM, clique em SSH. Uma nova janela é aberta com uma sessão de terminal na VM.

  3. Execute gcloud init para inicializar o SDK do Cloud na sua VM.

  4. Instale as chaves de assinatura do repositório do Apt usando o seguinte comando:

    curl https://us-central1-apt.pkg.dev/doc/repo-signing-key.gpg | sudo apt-key add -
    
  5. Atualização do Apt:

    sudo apt update
    
  6. Instale o auxiliar de credenciais do Apt na VM para permitir que o Apt execute a autenticação:

    sudo apt install apt-transport-artifact-registry
    
  7. 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.

Adicionar um pacote ao repositório

É possível fazer upload de um pacote para um repositório usando a ferramenta de linha de comando gcloudou importar um pacote armazenado no Cloud Storage. Se você criar pacotes usando o Cloud Build, os pacotes poderão ser armazenados no Cloud Storage para serem importados.

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

  1. Faça o download da planilha de referência rápida do Apt com o comando:

    sudo apt download apt-dpkg-ref
    

    O Apt faz o download da versão mais recente do pacote disponível nos repositórios do 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 ver o nome do arquivo da página de referência rápida do Apt. O nome do arquivo é semelhante a apt-dpkg-ref_5.3.1+nmu2_all.deb.

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

    gcloud beta artifacts apt upload quickstart-apt-repo \
        --location=us-central1 \
        --source=FILE_NAME
    

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

Ver o pacote no repositório

Verifique se o pacote foi adicionado ao repositório.

Console

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

    Abrir a página Repositórios

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

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

gcloud

Para listar os pacotes no repositório quickstart-apt-repo, execute o comando:

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

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

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

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 a seguir:

    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 cobranças na sua conta do Google Cloud pelos recursos usados nesta página, siga estas etapas:

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

Para excluir o repositório:

Console

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

    Abrir a página Repositórios

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

  3. Clique em Excluir.

gcloud

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

    gcloud artifacts repositories delete quickstart-apt-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
    

Para excluir a VM criada, execute o seguinte comando. Substitua VM_NAME pelo nome da VM.

gcloud compute instances delete VM_NAME

A seguir