Esta página foi traduzida pela API Cloud Translation.

Passo 1: crie um cluster

Antes de começar:

Estes passos pressupõem que criou variáveis de ambiente nos passos anteriores. Verifique-as 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.

Estes passos usam as seguintes variáveis de ambiente:

PROJECT_ID: o ID do seu projeto do Google Cloud. Consulte o início rápido híbrido – Passo 2: crie um projeto do Google Cloud
```
export PROJECT_ID=your_project_ID
```
ANALYTICS_REGION: a região na qual o seu projeto do GKE está a ser executado.A região de estatísticas da sua organização. Consulte o artigo Início rápido híbrido – Passo 4: crie uma organização
```
export ANALYTICS_REGION=your_analytics region
```
ORG_NAME: o nome da sua organização. Tem de corresponder ao ID do seu projeto do Google Cloud. Consulte o artigo Início rápido híbrido – Passo 4: crie uma organização
```
export ORG_NAME=your_organization_name
```
ENV_NAME: o nome do seu ambiente híbrido. Consulte o início rápido híbrido – Passo 6: crie um grupo de ambientes
```
export ENV_NAME=your_environment_name
```

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

Configure a shell do terminal

A ferramenta gcloud fornece a interface de linhas de comando principal para o Google Cloud, 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 na sua shell local. A ferramenta gcloud fornece a interface de linhas de comando principal para o Google Cloud, 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 da seguinte forma:
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 região de computação nos quais quer trabalhar.
Para apresentar as definições atuais, execute o seguinte comando:
```
gcloud config list
```
Se um projeto e/ou uma região de computação não estiverem listados, tem de os adicionar com os comandos apresentados abaixo. Se, a partir da saída da lista, determinar que tem de mudar as definições atuais para refletir o seu projeto e região de computação, também pode usar estes comandos:
```
gcloud config set project $PROJECT_ID
gcloud config set compute/region $ANALYTICS_REGION
```
Onde:
- PROJECT_ID é o nome do seu projeto do Google Cloud.
- ANALYTICS_REGION é o nome de uma região de computação do Google Cloud

Crie um cluster do GKE

Neste passo, vai criar um cluster do Kubernetes no seu projeto do Google Cloud (o projeto que configurou com o comando gcloud config representado por PROJECT_ID).

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

Crie o cluster

Crie a variável de ambiente CLUSTER_NAME com o seguinte comando (opcional):
```
export CLUSTER_NAME=cluster-name
```
Em que cluster-name é o nome que escolhe para o cluster.
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.
Nota: o tamanho do cluster que vai criar neste passo tem uma quantidade mínima de recursos adequados apenas para avaliação ou testes. Para obter informações mais detalhadas sobre os requisitos de recursos do 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 demorar alguns minutos. Após o êxito, é apresentado 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    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 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_apigee-hybrid. O nome inclui o nome de um projeto do Google Cloud (hybrid-project), uma região (us-central1) e um nome do cluster (apigee-hybrid).

kubectl config get-contexts

Os resultados devem ter um aspeto semelhante ao seguinte exemplo:

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 acabou de criar (o cluster no qual pretende instalar o Apigee hybrid). Com a saída get-contexts anterior, pode mudar para o contexto correto da seguinte forma:
```
kubectl config use-context context
```
Onde context é o nome completo do contexto do seu cluster, conforme apresentado pelo comando get-contexts anterior. Por exemplo: gke_apigee-project_us-west1_apigee-cluster.
Verifique o contexto atual para se certificar de que está definido para o cluster pretendido através do seguinte comando:
```
kubectl config current-context
```
Por exemplo:
```
gke_apigee-project_us-west1_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 introduzindo o seguinte comando:
```
gcloud container clusters get-credentials $CLUSTER_NAME
```
Em que CLUSTER_NAME é o nome do cluster que criou (o cluster no qual pretende instalar o Apigee hybrid).

Deverá ver um resultado semelhante ao seguinte:
```
Fetching cluster endpoint and auth data.
kubeconfig entry generated for example-cluster.
```

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

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

Deverá ver um resultado semelhante ao seguinte:

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

Resumo

Agora, tem um cluster do Kubernetes em execução no seu projeto do Google Cloud. O ambiente de shell está configurado e está pronto para instalar os serviços cert-manager e istio necessários para o Apigee hybrid na sua máquina local.

1 (NEXT) Passo 2: instale o cert-manager e o ASM 3 4 5