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.

  1. 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
  2. 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:
    3. gcloud components install kubectl
  3. 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).

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.

  1. 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
    
    
  2. 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.

  3. 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:

  1. 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).

  2. 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