Como começar a usar o gcloud com a Apigee

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

A CLI gcloud apigee permite que você faça o seguinte:

  • Visualizar proxies da API
  • Criar e gerenciar produtos de API
  • Implantar e remover proxies de API e ver os detalhes da implantação
  • Ver informações sobre desenvolvedores e apps
  • Listar seus ambientes e organizações
  • Gerenciar aplicativos de terceiros que chamam proxies da API Apigee

Além disso, a CLI gcloud beta apigee permite que você implante e gerencie arquivos no seu ambiente da Apigee.

As seções a seguir descrevem como instalar, autorizar e usar as CLIs gcloud apigee e gcloud beta apigee e, opcionalmente, definir variáveis de ambiente.

Antes de começar

Verifique se você atende aos pré-requisitos para usar a Apigee, incluindo a instalação do SDK do Google Cloud.

Como instalar os componentes da gcloud beta apigee

Para acessar os comandos gcloud beta apigee, instale o componente gcloud beta completo da seguinte maneira:

gcloud components install beta

Para confirmar que o componente beta foi instalado, digite o seguinte comando:

gcloud components list

Você verá o componente beta na lista da seguinte maneira:

Status Nome ID Tamanho
Instalado Comandos beta do gcloud beta < 1 MiB

Para mais informações, consulte Como gerenciar componentes do SDK.

Como autorizar o acesso ao gcloud

Autorize o acesso à CLI do gloud seguindo as etapas descritas em Como autorizar ferramentas do SDK do Cloud.

Por exemplo, para autorizar o acesso usando a conta de usuário e realizar outras etapas de configuração comuns do SDK do Cloud, use o seguinte comando:

gcloud init

Siga as instruções para autenticar a conta, conceder permissões de acesso e inicializar a instalação do SDK do Cloud, conforme descrito em Como inicializar o SDK do Cloud.

Como alternativa, para autorizar o acesso sem fazer nenhuma configuração adicional, use o seguinte comando:

gcloud auth login

Siga o fluxo de autorização baseado no navegador para autenticar a conta e conceder permissões de acesso.

Para mais informações sobre como autorizar e revogar o acesso à CLI gcloud, consulte Credenciais.

Como definir variáveis de ambiente para comandos gcloud

Os exemplos da API Apigee e da CLI gcloud fornecidos em toda a documentação usam uma ou mais das variáveis de ambiente definidas na tabela a seguir.

Ao definir as variáveis de ambiente com antecedência como valores significativos no seu ambiente, é possível copiar e colar as solicitações de exemplo para executá-las em seu próprio ambiente com modificações mínimas ou nenhuma modificação.

Variável de ambiente Descrição
$API Nome do proxy de API.
$APIPRODUCT Nome do produto da API.
$APP ID de um aplicativo.
$DEVELOPER_EMAIL Endereço de e-mail do desenvolvedor.
$ENV Nome do ambiente, como test ou prod.
$ID ID do recurso.
$KEY Chave do cliente.
$NAME Nome do recurso.
$ORG Sua organização da Apigee.
$REV Número da revisão do proxy de API.
$SHAREDFLOW Nome do fluxo compartilhado.
$TYPE Tipo de recurso.

Como usar a CLI gcloud

Use a CLI gcloud da seguinte maneira:

gcloud apigee GROUP [GCLOUD_WIDE_FLAG …]

Para mais informações sobre os grupos de comandos e sinalizações disponíveis, consulte gcloud apigee.

Por exemplo, o comando a seguir lista os proxies de API na sua organização:

gcloud apigee apis list --organization=$ORG

Veja a seguir um exemplo da resposta para a organização my-org:

Using Apigee organization `myorg`
 - hello-world
 - weather-app

Mais informações

Veja mais informações em: