Etapa 1: criar um cluster

Antes de começar:

Nestas etapas, presume-se que você tenha criado variáveis de ambiente nas etapas anteriores. Verifique com os seguintes comandos:

echo $PROJECT_ID
echo $ANALYTICS_REGION
echo $ORG_NAME
echo $ENV_NAME

Clique para ver descrições e comandos para definir as variáveis.

Estas etapas usam as seguintes variáveis de ambiente:

PROJECT_ID: o ID do projeto do Google Cloud. Consulte o Guia de início rápido do ambiente híbrido - Etapa 2: criar um projeto do Google Cloud.
```
export PROJECT_ID=your_project_ID
```
ANALYTICS_REGION: a região em que o projeto do GKE está em execução. A região de análise da organização. Consulte o Guia de início rápido do ambiente híbrido - Etapa 4: criar uma organização.
```
export ANALYTICS_REGION=your_analytics region
```
ORG_NAME: o nome da organização. Ele precisa corresponder ao ID do projeto do Google Cloud. Consulte o Guia de início rápido do ambiente híbrido - Etapa 4: criar uma organização.
```
export ORG_NAME=your_organization_name
```
ENV_NAME: o nome do ambiente híbrido. Consulte o guia de início rápido híbrido - Etapa 6: criar um grupo de ambientes.
```
export ENV_NAME=your_environment_name
```

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 Google Cloud 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 Google Cloud 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 conforme mostrado a seguir:
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. A definição dessas configurações facilita a execução dos comandos gcloud, porque gcloud requer que você especifique o projeto e a região de computação em que quer trabalhar.
Para listar as configurações atuais, execute o seguinte comando:
```
gcloud config list
```
Se um projeto e/ou região de computação não estiverem listados, será necessário adicioná-los com os comandos mostrados abaixo. Se, na saída da lista, você determinar que precisa mudar as configurações atuais para refletir seu projeto e a região de computação, também poderá usar estes comandos:
```
gcloud config set project $PROJECT_ID
gcloud config set compute/region $ANALYTICS_REGION
```
Em que:
- PROJECT_ID é o nome do projeto do Google Cloud;
- ANALYTICS_REGION é o nome de uma região de computação do Google Cloud;

Crie um cluster do GKE

Nesta etapa, você criará um cluster do Kubernetes no projeto do Google Cloud (o projeto definido com o comando gcloud config representado por PROJECT_ID).

Observação: o comando a seguir pressupõe que você definiu a configuração gcloud para a região de computação, conforme explicado nas etapas anteriores. Se você não definiu a configuração, precisará adicionar o parâmetro --region "compute-region" ao comando.

Observação: recomendamos que você verifique a versão padrão do Kubernetes e se ela atende aos requisitos de versão listados em Plataformas compatíveis. Para determinar qual versão do Kubernetes é a padrão, use o seguinte comando:

gcloud container get-server-config

Se não quiser usar o padrão, adicione a sinalização --cluster-version ao comando de criação do cluster. Para detalhes, consulte gcloud container clusters create.

Crie o cluster

Crie a variável de ambiente CLUSTER_NAME com o seguinte comando (opcional):
```
export CLUSTER_NAME=cluster-name
```
cluster-name é o nome que você escolhe para o cluster.
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 minimamente configurado e adequado para uma instalação de teste híbrida da Apigee.
Observação: o tamanho do cluster que você criará nesta etapa tem uma quantidade mínima de recursos adequados apenas para avaliação ou teste. Para informações mais detalhadas sobre os requisitos de recursos de cluster para ambientes de produção e não produção, consulte:
- Requisitos do cluster de produção do GKE
- Requisitos do cluster de não produção do GKE
```
gcloud container clusters create $CLUSTER_NAME \
--machine-type "e2-standard-4" --num-nodes "4" --enable-autoscaling --min-nodes "3" --max-nodes "6"
```
A criação do cluster pode levar alguns minutos. Após a conclusão, o resultado será semelhante ao seguinte, com um status RUNNING:
```
NAME           LOCATION       MASTER_VERSION  MASTER_IP     MACHINE_TYPE   NODE_VERSION   NUM_NODES  STATUS
apigee-hybrid  us-central1    1.15.12-gke.2   35.222.54.89  e2-standard-4  1.15.12-gke.2             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_apigee-hybrid. O nome inclui o nome de um projeto do Google Cloud (hybrid-project), uma região (us-central1) e um nome de cluster (apigee-hybrid).

kubectl config get-contexts

Os resultados terão a aparência do exemplo a seguir:

CURRENT   NAME                                             CLUSTER                                          AUTHINFO                                           NAMESPACE
*         gke_hybrid-project_us-central1_apigee-hybrid     gke_hybrid-project_us-central1_apigee-hybrid     gke_hybrid-project_us-central1_apigee-hybrid
          gke_apigee-project_us-west1_apigee-cluster       gke_apigee-project_us-west1_apigee-cluster       gke_apigee-project_us-west1_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). Usando a saída get-contexts anterior, alterne para o contexto correto da seguinte maneira:
```
kubectl config use-context context
```
Em que context é o nome do contexto completo do cluster como saída pelo comando get-contexts anterior. Por exemplo, gke_apigee-project_us-west1_apigee-cluster.
Verifique se o contexto atual está definido como o cluster pretendido usando o seguinte comando:
```
kubectl config current-context
```
Exemplo:
```
gke_apigee-project_us-west1_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 o papel cluster-admin:

Para buscar as credenciais, digite este comando:
```
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 a Apigee híbrida).

Uma resposta semelhante a esta será exibida:
```
Fetching cluster endpoint and auth data.
kubeconfig entry generated for example-cluster.
```

Defina a vinculação de papel do cluster. Execute o comando a seguir exatamente como mostrado:

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

Uma resposta semelhante a esta será exibida:

clusterrolebinding.rbac.authorization.k8s.io/cluster-admin-binding created

Resumo

Agora você tem um cluster do Kubernetes em execução no projeto do Google Cloud. Seu ambiente shell está configurado e você está pronto para instalar os serviços cert-manager e istio exigidos pela Apigee híbrida na máquina local.

1 (A SEGUIR) Etapa 2: Instalar o Cert-manager e o ASM 3 4 5