Armazene pacotes RPM no Artifact Registry

Este início rápido mostra como configurar um repositório Yum do Artifact Registry privado, adicionar um pacote RPM ao repositório e instalar o pacote numa VM do Compute Engine que executa o sistema operativo CentOS 7. Para saber como configurar repositórios Yum que usam o DNF, consulte o artigo Configurar VMs para instalar pacotes RPM.

Para saber mais sobre a gestão de pacotes RPM, consulte o artigo Trabalhar com pacotes RPM.

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

  4. 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-yum-repo como o nome do repositório.

      4. Selecione Yum 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 Yum no projeto atual com o nome quickstart-yum-repo na localização u-france-east1.

        gcloud artifacts repositories create quickstart-yum-repo \
            --repository-format=yum \
            --location=u-france-east1 \
            --description="Yum 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 yum upload.

    1. No Cloud Shell, transfira o editor de texto nano com o comando:

      sudo yum install --downloaddir=. --downloadonly nano
      

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

      Loaded plugins: fastestmirror
      Loading mirror speeds from cached hostfile
       * base: mirror.dal.nexril.net
       * epel: ord.mirror.rackspace.com
       * extras: centos.mirror.lstn.net
       * updates: ftpmirror.your.org
      Resolving Dependencies
      --> Running transaction check
      ---> Package nano.x86_64 0:2.3.1-10.el7 will be installed
      --> Finished Dependency Resolution
      
      Dependencies Resolved
      
      ================================================================================
       Package        Arch             Version                   Repository      Size
      ================================================================================
      Installing:
       nano           x86_64           2.3.1-10.el7              base           440 k
      
      Transaction Summary
      ================================================================================
      Install  1 Package
      
      Total download size: 440 k
      Installed size: 1.6 M
      Background downloading packages, then exiting:
      nano-2.3.1-10.el7.x86_64.rpm                               | 440 kB   00:00
      exiting because "Download Only" specified
      

      Execute ls para obter o nome do ficheiro do pacote. O nome do ficheiro é semelhante a nano-2.3.1-10.el7.x86_64.rpm.

    2. Para simplificar os comandos gcloud, defina o repositório predefinido como quickstart-yum-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-yum-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 yum upload para carregar o pacote para o repositório:

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

      Substitua FILE_NAME pelo caminho para o pacote nano.

    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-yum-repo.

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

    gcloud

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

     gcloud artifacts packages list
    

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

    gcloud artifacts versions list --package=nano
    

    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 com o nome quickstart-yum-vm.

    gcloud compute instances create quickstart-yum-vm \
        --image-family=centos-7 \
        --image-project=centos-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 Yum 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. Atualize o Yum:

      sudo yum makecache
      
    4. Instale o auxiliar de credenciais do Yum na VM para permitir que o Yum faça a autenticação através do seguinte comando:

      sudo yum install yum-plugin-artifact-registry
      
    5. Configure a sua VM para aceder aos pacotes do Artifact Registry} através do seguinte comando:

      sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOF
      [yum-quickstart]
      name=My Repository
      baseurl=https://u-france-east1-yum.s3nsregistry.fr/projects/PROJECT/quickstart-yum-repo
      enabled=1
      repo_gpgcheck=0
      gpgcheck=0
      EOF
      

      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 yum makecache
      
    2. Instale o pacote no seu repositório.

      sudo yum --enablerepo=yum-quickstart install nano
      

      Introduza y quando lhe for pedido.

      As informações de instalação devolvidas têm o seguinte aspeto:

      Loaded plugins: fastestmirror
      Loading mirror speeds from cached hostfile
       * base: mirrors.cmich.edu
       * epel: ord.mirror.rackspace.com
       * extras: mirror.team-cymru.com
       * updates: mirror.us-midwest-1.nexcess.net
      quickstart-yum-repo                                      | 1.3 kB     00:00
      Resolving Dependencies
      --> Running transaction check
      ---> Package nano.x86_64 0:2.3.1-10.el7 will be installed
      --> Finished Dependency Resolution
      
      Dependencies Resolved
      
      ================================================================================
       Package        Arch             Version                   Repository      Size
      ================================================================================
      Installing:
       nano           x86_64           2.3.1-10.el7              base           440 k
      
      Transaction Summary
      ================================================================================
      Install  1 Package
      
      Total size: 440 k
      Installed size: 1.6 M
      Is this ok [y/d/N]: y
      Downloading packages:
      Running transaction check
      Running transaction test
      Transaction test succeeded
      Running transaction
        Installing : nano-2.3.1-10.el7.x86_64                                     1/1
        Verifying  : nano-2.3.1-10.el7.x86_64                                     1/1
      
      Installed:
        nano.x86_64 0:2.3.1-10.el7
      
      Complete!
      

    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-yum-repo.

    3. Clique em Eliminar.

    gcloud

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

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

    O que se segue?