Etapa 7: implante em um ambiente da Apigee

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

Confira a documentação da Apigee Edge.

Depois de concluir o desenvolvimento e os testes locais com a Apigee no VS Code, você estará pronto para implantar a API como um arquivo em um ambiente da Apigee. Nesta etapa, você criará um ambiente da Apigee compatível com a implantação de arquivos e implantará um arquivo da configuração do proxy de API no ambiente da Apigee.

Antes de começar: instale o SDK do Google Cloud e o componente gcloud beta apigee, conforme descrito em Primeiros passos usando a gcloud com a Apigee.

Siga as etapas em Criar um ambiente para realizar o seguinte:
1. Crie um novo ambiente dev na sua organização da Apigee, ativando Archive como o tipo de implantação. Use a IU ou a API.
  Exemplo:
2. Anexe o ambiente à instância de ambiente de execução usando a API Instances attachment.
  Esse comando aciona uma operação de longa duração. Verifique se o ambiente foi anexado ao ambiente de execução antes de continuar.
3. Crie um grupo de ambiente, se você ainda não tiver um, usando a API de criação de grupos de ambiente.
  Verifique se o grupo de ambiente foi criado antes de continuar. Verifique o status do novo grupo usando uma solicitação como esta:
```
curl -i -H "$AUTH" -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
```
4. Anexe o novo ambiente ao grupo de ambientes usando a API Environment group attachment.
  Anexar um ambiente ao grupo deixa os proxies nesse ambiente roteáveis pelos nomes dos hosts no grupo. Isso aciona uma operação de longa duração que pode levar vários minutos para ser concluída. Recomendamos que você aguarde um ou dois minutos antes de prosseguir para a próxima etapa. Enquanto isso, verifique o status da operação como antes.
Implante um arquivo da configuração do proxy de API no ambiente da Apigee.
1. Na guia Terminal no VS Code na Apigee, navegue até o diretório myapigeeworkspace.
```
cd myapigeeworkspace
```
  Para executar ls, o diretório precisa conter a pasta src.
2. Execute este comando:
```
gcloud beta apigee archives deploy --environment=dev --labels=release=052021
```
  Veja a seguir um exemplo de resposta:
```
Using Apigee organization dev
Waiting for operation [b64c2665-b5ac-43cc-9e2d-232e8895c2ed] to complete...done
```
Execute o seguinte comando na guia Terminal para testar a API:
```
curl https://INTERNAL_LOAD_BALANCER_IP/helloworld /
  -H "Host: ENV_GROUP_HOSTNAME" 
```
Para mais informações sobre as variáveis neste exemplo e como configurar o acesso à API, consulte Implantar um exemplo de proxy.

A seguinte mensagem de erro é exibida:
```
{"fault":{"faultstring":"Failed to resolve API Key variable request.queryparam.apikey",
  "detail":{"errorcode":"steps.oauth.v2.FailedToResolveAPIKey"}}}
```
Você precisa criar um produto de API que inclua a API helloworld e, em seguida, criar e registrar um desenvolvedor com o produto da API para receber uma chave de API.

Receber uma chave de API.

Criar um produto da API usando a IU da Apigee:

Selecione Publicar > Produtos da API.
Clique em + Criar.
Insira os detalhes do produto do produto de API.

Digite as seguintes informações nos campos:

Campo	Configuração
`Name:`	myproduct
`Display name:`	myproduct
`Environment:`	desenvolvimento
`Access:`	Público
`Quota:`	Deixar em branco
`Allowed OAuth scope:`	Deixar em branco

Na seção Operações, clique em + Adicionar uma operação.
Em Origem, selecione helloworld no menu suspenso Proxy de API.
Em Operação, no campo "Caminho", digite /.
Não altere os outros campos.
Clique em Salvar para salvar a operação.
Clique em Salvar para salvar o produto da API.

Crie um desenvolvedor na sua organização:

Selecione Publicar > Desenvolvedores no menu de navegação.
Clique em + Desenvolvedor.

Digite as seguintes informações nos campos:

Campo	Configuração
`First Name:`	Alex
`Last Name:`	Hamilton
`Username:`	ahamilton
`Email:`	ahamilton@example.com

Clique em Criar.

Registrar um aplicativo:

Selecione Publicar > Apps.
Clique em + App.

Digite as seguintes informações nos campos:

Campo	Configuração
`Name:`	myapp
`Display name:`	myapp
`Developer:`	ahamilton@example.com
`Callback URL:`	Deixar em branco
`Notes:`	Deixar em branco
`Expiry:`	Nunca
`Product:`	Clique em Adicionar produto. Selecione myproduct. Clique em Add.
`Custom attributes:`	Deixar em branco

Copie a chave de API.
1. Na página Apps (Publicar > Apps), clique em myapp.
2. Na página myapp, clique em Mostrar ao lado de Chave na seção Credenciais. A chave de API está associada ao produto de API que você criou.
3. Selecione e copie a chave de API.

Execute a chamada de curl novamente transmitindo a chave de API usando o parâmetro de consulta apikey da seguinte maneira:

curl -v https://$PUBLIC_FACING_IP/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

A seguinte resposta é retornada:

{
  "root": {
    "city": "San Jose",
    "firstName": "John",
    "lastName": "Doe",
    "state": "CA"
  }
}

Parabéns! Você implantou o arquivo da API em um ambiente da Apigee!

Na próxima etapa, você promoverá um arquivo da API para um ambiente de produção da Apigee.

1 2 3 4 5 6 7 (A SEGUIR) Etapa 8: promover um arquivo para a produção