Algumas ou todas as informações nesta página podem não se aplicar ao Cloud de Confiance da S3NS. Consulte Diferenças do Google Cloud para saber mais.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Armazenar pacotes RPM no Artifact Registry

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

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

Antes de começar

In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
- Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector
Verify that billing is enabled for your Cloud de Confiance project.
Enable the Artifact Registry API.
Roles required to enable APIs
To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.
Enable the API

Funções exigidas

Para receber as permissões necessárias para criar e gerenciar repositórios de pacotes Yum do Artifact Registry, peça ao administrador para conceder a você o papel do IAM de Administrador do Artifact Registry (roles/artifactregistry.admin) no seu projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível receber as permissões necessárias por meio de papéis personalizados ou outros papéis predefinidos.

Instalar a CLI gcloud

Instale e inicialize a Google Cloud CLI se ela ainda não estiver instalada. Para uma instalação atual, atualize os componentes da Google Cloud CLI com o comando:
```
gcloud components update
```
Para verificar sua versão da CLI gcloud, execute o comando:
```
gcloud version
```
Observação: no Ubuntu, use o pacote Debian para instalar a CLI gcloud. O pacote snap da CLI gcloud não inclui kubectl ou extensões para autenticar com o Artifact Registry usando a CLI gcloud.

Criar um repositório

Crie o repositório para seus artefatos.

Crie o repositório:
Console
1. Abra a página Repositórios no Cloud de Confiance console.
  
  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 o formato.
5. Em Tipo de local, selecione Região e escolha o local 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 chamado quickstart-yum-repo no local 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

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 Google Cloud CLI ou importar um pacote armazenado no Cloud Storage.

Neste guia de início rápido, você vai fazer upload de um arquivo de amostra usando o gcloud artifacts yum upload comando.

No Cloud Shell, 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 disponível nos repositórios 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 do arquivo é semelhante a nano-2.3.1-10.el7.x86_64.rpm.

Para simplificar os comandos gcloud, defina o repositório padrão como quickstart-yum-repo e o local padrão como u-france-east1. 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 u-france-east1
```
Saiba mais sobre esses comandos na documentação do gcloud config set.
Execute o gcloud artifacts yum upload para fazer upload do pacote para o repositório:
```
gcloud artifacts yum upload quickstart-yum-repo \
    --source=FILE_NAME
```
Substitua FILE_NAME pelo caminho do pacote nano.

Ver o pacote no repositório

Verifique se o pacote foi adicionado ao repositório.

Console

Abra a página Repositórios no Cloud de Confiance console.

Abrir a página Repositórios
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

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

gcloud artifacts versions list --package=nano

Criar uma VM

Crie uma nova VM do Compute Engine em que você vai instalar o pacote de amostra.

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

gcloud compute instances create quickstart-yum-vm \
    --image-family=centos-7 \
    --image-project=centos-cloud \
    --scopes=cloud-platform

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

Configurar o gerenciador de pacotes

Para instalar um pacote na VM, adicione o repositório criado ao arquivo Yum que define os repositórios de pacotes.

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

Abrir a página "Instâncias de VM"
Na linha com sua VM, clique em SSH. Uma nova janela será aberta com uma sessão de terminal na VM.
Atualize o Yum:
```
sudo yum makecache
```
Instale o auxiliar de credenciais do Yum na VM para permitir que o Yum execute a autenticação usando o seguinte comando:
```
sudo yum install yum-plugin-artifact-registry
```

Configure sua VM para acessar 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://u-france-east1-yum.s3nsregistry.fr/projects/PROJECT/quickstart-yum-repo
enabled=1
repo_gpgcheck=0
gpgcheck=0
EOF

Substitua PROJECT por seu Cloud de Confiance by S3NS ID de projeto.

Instale o pacote

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

Atualize a lista de pacotes disponíveis:
```
sudo yum makecache
```

Instale o pacote no 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 conta do Cloud de Confiance pelos recursos usados nesta página, siga as etapas abaixo.

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

Abra a página Repositórios no Cloud de Confiance console.

Abrir a página Repositórios
Na lista de repositórios, selecione o repositório quickstart-yum-repo.
Clique em Excluir.

gcloud

Para excluir o repositório quickstart-yum-repo, execute o seguinte comando:
```
gcloud artifacts repositories delete quickstart-yum-repo
```
Se quiser remover as configurações padrão de repositório e localização que definiu como 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:

gcloud compute instances delete quickstart-yum-vm

A seguir

Saiba como trabalhar com pacotes RPM.
Leia sobre DevOps e conheça o programa de pesquisa de DevOps.