Guia de início rápido para a RPM

Neste guia de início rápido, mostramos como configurar um repositório Yum do Artifact Registry, adicionar um pacote RPM ao repositório e instalar o pacote. Para saber como configurar os repositórios do Yum que usam o DNF, consulte Como configurar VMs para instalar pacotes de RPM.

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

Para saber mais sobre como gerenciar pacotes de RPM, consulte Como trabalhar com pacotes de RPM.

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=centos-7 \
          --image-project=centos-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-yum-repo como o nome do repositório.

    4. Selecione Yum como 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 Yum no projeto atual chamado quickstart-yum-repo no local us-central1.

      gcloud artifacts repositories create quickstart-yum-repo \
          --repository-format=yum \
          --location=us-central1 \
          --description="Yum 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-yum-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-yum-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 Yum 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. Atualize o Yum:

    sudo yum makecache
    
  4. Instale o auxiliar de credenciais do Yum na VM para permitir que ele execute a autenticação usando o seguinte comando:

    sudo yum install yum-plugin-artifact-registry
    
  5. Configure a VM para acessar os pacotes do Artifact Registry usando o seguinte comando:

    sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOF
    [yum-quickstart]
    name=My Repository
    baseurl=https://us-central1-yum.pkg.dev/projects/PROJECT/quickstart-yum-repo
    enabled=1
    repo_gpgcheck=0
    gpgcheck=0
    EOF
    

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

  1. Faça o download do editor de texto nano com o comando:

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

    O Yum faz o download da versão mais recente do pacote que está 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 receber o nome do arquivo do pacote. O nome de arquivo é semelhante a nano-2.3.1-10.el7.x86_64.rpm.

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

    gcloud beta artifacts yum upload quickstart-yum-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-yum-repo.

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

gcloud

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

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

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

gcloud artifacts versions list --package=nano

Instale o pacote

Instale o pacote que você 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
    

    Digite y quando solicitado.

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

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

  3. Clique em Excluir.

gcloud

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

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