Etapa 1: criar um cluster GKE

Nesta etapa, explicamos como configurar o ambiente de shell e criar um cluster do GKE no projeto do Google Cloud Platform (GCP).

Configurar o shell do terminal

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

Certifique-se de que o gcloud e o kubectl estejam instalados no shell local. A ferramenta gcloud fornece a principal interface de linha de comando do GCP e kubectl fornece a principal interface de linha de comando para executar comandos em clusters do Kubernetes.
```
gcloud -h
kubectl -h
```
Se você não tiver esses utilitários instalados, instale-os agora:
1. Instale o SDK do Cloud , que inclui a ferramenta de linha de comando gcloud.
2. Depois de instalar o SDK do Cloud, execute o comando a seguir para instalar a ferramenta de linha de comando kubectl:
Use a ferramenta gcloud para definir duas configurações padrão: projeto e região do Compute. O ajuste dessas configurações facilita a execução dos comandos gcloud, porque gcloud requer que você especifique o projeto e a zona do Compute em que você quer trabalhar.
Para listar as configurações atuais:
```
gcloud config list
```
Se um projeto e/ou zona de computação não estiver listado, adicione-os com os comandos mostrados abaixo. Se, na saída da lista, você determinar que precisa mudar as configurações atuais para refletir o projeto e a região (ou zona) de computação, 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. Exemplo: compute/region us-central1. Para uma lista de regiões e zonas de computação, consulte Regiões e zonas disponíveis.

Criar um cluster do GKE

Nesta etapa, você criará um cluster do Kubernetes no seu projeto do GCP (o projeto que você definiu com o comando gcloud config).

OBSERVAÇÃO: o comando a seguir pressupõe que você definiu a configuração gcloud para a região e/ou zona de computação, conforme explicado nas etapas anteriores. Se você não definiu a configuração, será necessário adicionar o parâmetro --region "compute-region" e/ou --zone "compute-zone" ao comando.

Execute o comando a seguir para criar o cluster. O tipo de máquina, o número de nós e outras configurações especificadas no comando criam um cluster mínimo configurado adequado para uma instalação híbrida da Apigee:

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

cluster-name é o nome que você escolhe para o cluster.

A criação do cluster pode levar alguns minutos. Após a conclusão, você verá uma saída semelhante à seguinte com um status 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 usuário e um namespace. O contexto atual é o cluster que é o padrão para kubectl no momento: todos os comandos kubectl são executados nesse cluster.

Verifique se o contexto gcloud atual está definido como o cluster que você acabou de criar.

Primeiro, liste os contextos para determinar qual é o contexto atual. No exemplo a seguir, o contexto atual é gke_hybrid-project_us-central1-a_apigee-hybrid. O nome inclui o nome de um projeto do GCP (hybrid-project), uma região ou zona (us-central1-a) e um nome de 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 você acabou de criar (o cluster em que pretende instalar a Apigee híbrida). Supondo que a saída get-contexts anterior, se o nome do cluster que você criou fosse apigee-cluster na região us-west1, você alternaria para o contexto gke_apigee-project_us-west1-a_apigee-cluster, da seguinte maneira:
```
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 você quer alternar.
Verifique o contexto atual para ter certeza de que ele está definido como o cluster pretendido. Exemplo:
```
kubectl config current-context
 gke_apigee-project_us-west1-a_apigee-cluster
```

Conceder credenciais de cluster

As credenciais do cluster dão acesso aos contêineres em execução no cluster. Busque suas credenciais e conceda a si mesmo o papel cluster-admin:

Busque as credenciais:
```
gcloud container clusters get-credentials cluster-name
```
Em que cluster-name é o nome do cluster que você criou (o cluster em que você pretende instalar o híbrido da Apigee).

Defina a vinculação de papel 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 você tem um cluster do Kubernetes em execução no projeto do GCP. Seu ambiente de shell está configurado e você está pronto para instalar o software de plano de ambiente de execução do híbrido da Apigee na máquina local.

1 (A SEGUIR) Etapa 4: instalar a apigeectl 3 4