Guia de início rápido para Red Hat e Centos

Nesta página, você verá como instalar o SDK do Google Cloud, inicializá-lo e executar os principais comandos gcloud a partir da linha de comando.

Antes de começar

Crie um projeto do Google Cloud Platform, se você ainda não tiver um.

Os pacotes de RPM do SDK do Cloud são compatíveis com o Red Hat Enterprise Linux 7, o Red Hat Enterprise Linux 8, o CentOS 7 e o Fedora Core (versão 29 e posterior). É possível instalar o pacote usando o gerenciador de pacotes yum ou dnf:

# Update YUM with Cloud SDK repo information:
    sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
    [google-cloud-sdk]
    name=Google Cloud SDK
    baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el7-x86_64
    enabled=1
    gpgcheck=1
    repo_gpgcheck=1
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
           https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
    EOM

    # The indentation for the 2nd line of gpgkey is important.

    # Install the Cloud SDK
    sudo yum install google-cloud-sdk
    

Inicializar o SDK

Use o comando gcloud init para executar várias tarefas comuns de configuração do SDK. Entre elas: autorizar as ferramentas do SDK a acessar o Google Cloud Platform usando as credenciais da sua conta de usuário e definir a configuração padrão do SDK.

Para iniciar o SDK:

  1. Execute o seguinte em um prompt de comando:

    gcloud init
        

    Observação: se surgir um erro relacionado ao comando gcloud não ter sido encontrado, consulte a etapa 5 na seção acima.

    Observação: para impedir que o comando inicie um navegador da Web, use gcloud init --console-only. Para autorizar sem um navegador da Web e de forma não interativa, crie uma conta de serviço com os escopos apropriados usando o Console do Google Cloud Platform e usando gcloud auth activate-service-account com o arquivo de chave JSON correspondente.

  2. Aceite a opção de fazer login com sua conta de usuário do Google:

        To continue, you must log in. Would you like to log in (Y/n)? Y
        
  3. No seu navegador, faça login na sua conta de usuário do Google quando solicitado e clique em Permitir para permitir acesso aos recursos do Google Cloud Platform.

  4. No prompt de comando, selecione um projeto do Cloud Platform da lista daqueles em que você tem permissão de proprietário, editor ou visualizador:

        Pick cloud project to use:
         [1] [my-project-1]
         [2] [my-project-2]
         ...
         Please enter your numeric choice:
        

    Se você tiver apenas um projeto, gcloud init o selecionará para você.

  5. Se a API do Google Compute Engine estiver ativada, gcloud init permitirá que você escolha uma zona padrão do Compute Engine:

        Which compute zone would you like to use as project default?
         [1] [asia-east1-a]
         [2] [asia-east1-b]
         ...
         [14] Do not use default zone
         Please enter your numeric choice:
        

    gcloud init confirma que você concluiu as etapas de configuração corretamente:

        gcloud has now been configured!
        You can use [gcloud config] to change more gcloud settings.
    
        Your active configuration is: [default]
        
  6. (Opcional) Se você quiser uma experiência de leitor de tela mais otimizada, a ferramenta de linha de comando gcloud vem com uma propriedade accessibility/screen_reader.

    Para ativar essa propriedade, execute:

    gcloud config set accessibility/screen_reader true
        

    Para mais detalhes sobre os recursos de acessibilidade que acompanham a ferramenta de linha de comando gcloud, consulte este guia.

Executar comandos gcloud básicos

Execute estes comandos gcloud para visualizar informações sobre sua instalação do SDK:

  1. Para listar contas com as credenciais armazenadas no sistema local:

    gcloud auth list
        

    gcloud exibe uma lista de contas credenciadas:

               Credentialed Accounts
        ACTIVE             ACCOUNT
        *                  example-user-1@gmail.com
                           example-user-2@gmail.com
        
  2. Para listar as propriedades na configuração ativa do SDK:

    gcloud config list
        

    gcloud exibe a lista de propriedades:

        [core]
        account = example-user-1@gmail.com
        disable_usage_reporting = False
        project = example-project
        
  3. Para ver informações de instalação do SDK do Cloud e de configuração ativa do SDK:

    gcloud info
        

    gcloud exibe um resumo das informações sobre a instalação do SDK do Cloud. Isso inclui informações sobre o sistema, os componentes do SDK instalados, a conta de usuário ativa, o projeto atual e as propriedades da configuração ativa do SDK.

  4. Para visualizar informações sobre os comandos gcloud e outros tópicos na linha de comando:

    gcloud help
        

    Por exemplo, para visualizar a ajuda para gcloud compute instances create:

    gcloud help compute instances create
        

    gcloud exibe um tópico de ajuda que contém uma descrição do comando, uma lista de sinalizações e argumentos de comando e exemplos de como usá-lo.

A seguir

  • Leia o guia da ferramenta gcloud para uma visão geral da ferramenta de linha de comando gcloud, incluindo uma rápida introdução aos principais conceitos, convenções de comando e dicas úteis.
  • Leia o guia de referência da gcloud para páginas detalhadas sobre cada comando gcloud, incluindo descrições, sinalizações e exemplos que podem ser usados para executar diversas tarefas no Google Cloud Platform.
  • Instale outros pacotes de YUM do SDK do Cloud.