Esta página foi traduzida pela API Cloud Translation.

Passo 1: crie um cluster do GKE

Este passo explica como configurar o ambiente de shell e criar um cluster do GKE no seu projeto da Google Cloud Platform (GCP).

Configure a shell do terminal

A ferramenta gcloud fornece a interface de linhas de comando principal para a GCP e a ferramenta kubectl fornece a interface de linhas de comando principal para executar comandos em clusters do Kubernetes.

Certifique-se de que tem o gcloud e o kubectl instalados no seu shell local. A ferramenta gcloud fornece a interface de linhas de comando principal para a GCP e a ferramenta kubectl fornece a interface de linhas de comando principal para executar comandos em clusters do Kubernetes.
```
gcloud -h
kubectl -h
```
Se não tiver estas utilidades instaladas, instale-as agora:
1. Instale o SDK Cloud, que inclui a ferramenta de linha de comandos gcloud.
2. Depois de instalar o SDK Cloud, instale a ferramenta de linha de comandos kubectl executando o seguinte comando:
Use a ferramenta gcloud para configurar duas predefinições: o seu projeto predefinido e a região de computação. A configuração destas definições facilita a execução de comandos gcloud, porque gcloud requer que especifique o projeto e a zona de computação nos quais quer trabalhar.
Para listar as definições atuais:
```
gcloud config list
```
Se um projeto e/ou uma zona de computação não estiverem listados, tem de os adicionar com os comandos apresentados abaixo. Se, a partir do resultado da lista, determinar que tem de mudar as definições atuais para refletir o seu projeto e região de computação (ou zona), também pode usar estes comandos:
```
gcloud config set project project-id
gcloud config set compute/region compute-region
gcloud config set compute/zone compute-zone
```
Em que project-id é o nome do seu projeto do GCP, compute-region é o nome de uma região de computação do GCP e compute-zone é o nome de uma zona de computação do GCP. Por exemplo: compute/region us-central1. Para ver uma lista das regiões e zonas de computação, consulte o artigo Regiões e zonas disponíveis.

Crie um cluster do GKE

Neste passo, vai criar um cluster do Kubernetes no seu projeto da GCP (o projeto que configurou com o comando gcloud config).

NOTA: o comando seguinte pressupõe que definiu a configuração gcloud para a região e/ou a zona de computação, conforme explicado nos passos anteriores. Se não definiu a configuração, tem de adicionar o parâmetro --region "compute-region" e/ou --zone "compute-zone" ao comando.

Execute o seguinte comando para criar o cluster. O tipo de máquina, o número de nós e outras definições especificadas no comando criam um cluster configurado de forma mínima adequado para uma instalação de avaliação do Apigee Hybrid:

gcloud container clusters create cluster-name \
--machine-type "n1-standard-4" --num-nodes "3" --enable-autoscaling --min-nodes "3" --max-nodes "6"

Em que cluster-name é o nome que escolhe para o cluster.

A criação do cluster pode demorar alguns minutos. Se for bem-sucedido, vai ver um resultado semelhante ao seguinte com o estado RUNNING:

NAME           LOCATION       MASTER_VERSION  MASTER_IP     MACHINE_TYPE   NODE_VERSION   NUM_NODES  STATUS
apigee-hybrid  us-central1-a  1.13.11-gke.9   35.222.54.89  n1-standard-4  1.13.11-gke.9  3          RUNNING

Definir o contexto atual

Um contexto é um grupo de parâmetros de acesso. Cada contexto contém um cluster do Kubernetes, um utilizador e um espaço de nomes. O contexto atual é o cluster que é atualmente o predefinido para kubectl: todos os comandos kubectl são executados em relação a esse cluster.

Certifique-se de que o contexto gcloud atual está definido para o cluster que acabou de criar.

Primeiro, liste os contextos para determinar qual é o contexto atual. No exemplo seguinte, o contexto atual é gke_hybrid-project_us-central1-a_apigee-hybrid. O nome inclui o nome de um projeto da GCP (hybrid-project), uma região ou uma zona (us-central1-a) e um nome do cluster (apigee-hybrid):

kubectl config get-contexts
CURRENT   NAME                                             CLUSTER                                          AUTHINFO                                           NAMESPACE
*         gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid
          gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster

Se necessário, defina o contexto atual para o cluster que acabou de criar (o cluster no qual pretende instalar o Apigee hybrid). Partindo do princípio da saída get-contexts anterior, se o nome do cluster que criou fosse apigee-cluster na região us-west1, mudaria para o contexto gke_apigee-project_us-west1-a_apigee-cluster, da seguinte forma:
```
kubectl config use-context gke_apigee-project_us-west1-a_apigee-cluster
```
Em que gke_apigee-project_us-west1-a_apigee-cluster é o nome do contexto para o qual mudar.
Verifique o contexto atual para se certificar de que está definido para o cluster pretendido. Por exemplo:
```
kubectl config current-context
 gke_apigee-project_us-west1-a_apigee-cluster
```

Conceda credenciais de cluster

As credenciais do cluster dão-lhe acesso aos contentores em execução no cluster. Obtenha as suas credenciais e atribua a si mesmo a função cluster-admin:

Obtenha as credenciais:
```
gcloud container clusters get-credentials cluster-name
```
Onde cluster-name é o nome do cluster que criou (o cluster no qual pretende instalar o Apigee hybrid).

Defina a associação de funções do cluster. Execute este comando exatamente como mostrado:

kubectl create clusterrolebinding cluster-admin-binding \
--clusterrole cluster-admin --user $(gcloud config get-value account)

Resumo

Agora, tem um cluster do Kubernetes em execução no seu projeto da GCP. O ambiente de shell está configurado e tem tudo a postos para instalar o software do plano de tempo de execução híbrido do Apigee na sua máquina local.

1 (NEXT) Passo 2: instale o apigeectl 3 4