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 okubectl
estejam instalados no shell local. A ferramentagcloud
fornece a principal interface de linha de comando do GCP ekubectl
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:
- Instale o SDK do Cloud ,
que inclui a ferramenta de linha de comando
gcloud
. - Depois de instalar o SDK do Cloud, execute o comando a seguir para
instalar a ferramenta de linha de comando
kubectl
:
gcloud components install kubectl
- Instale o SDK do Cloud ,
que inclui a ferramenta de linha de comando
-
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 comandosgcloud
, porquegcloud
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.
Crie 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
).
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.14.10-gke.27 35.222.54.89 n1-standard-4 1.14.10-gke.27 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 fosseapigee-cluster
na regiãous-west1
, você alternaria para o contextogke_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 (PRÓXIMA) Etapa 2: instalar o apigeectl 3 4