Etapa 11: instalar a Apigee híbrida usando os gráficos do Helm

Instalar os gráficos do Helm da Apigee híbrida

Nesta etapa, você vai usar o Helm para instalar os seguintes componentes da Apigee híbrida:

  • Operador da Apigee
  • Armazenamento de dados da Apigee
  • Telemetria da Apigee
  • Redis da Apigee
  • Gerenciador de entrada da Apigee
  • Organização da Apigee
  • Seus ambientes da Apigee

Você vai instalar os gráficos para cada ambiente, um por vez. A sequência de instalação dos componentes é importante.

  1. Caso contrário, acesse o diretório APIGEE_HELM_CHARTS_HOME. Execute os comandos a seguir nesse diretório.
  2. Instale o operador/controlador da Apigee:

    Simulação:

    helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  --atomic \
  -f overrides.yaml \
  --dry-run

    Instale o gráfico:

    helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  --atomic \
  -f overrides.yaml

    Verifique a instalação do operador da Apigee:

    helm ls -n apigee-system

    NAME           NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                   APP VERSION
operator    apigee-system   3               2023-06-26 00:42:44.492009 -0800 PST    deployed        apigee-operator-1.11.2   1.11.2

    Para saber se ele está funcionando, confira a disponibilidade:

    kubectl -n apigee-system get deploy apigee-controller-manager

    NAME                        READY   UP-TO-DATE   AVAILABLE   AGE
apigee-controller-manager   1/1     1            1           7d20h

  3. Instale o repositório de dados da Apigee:

    Simulação:

    helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

    Instale o gráfico:

    helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

    Confira o estado de apigeedatastore para verificar se ele está em execução antes de continuar com a próxima etapa:

    kubectl -n apigee get apigeedatastore default

    NAME      STATE       AGE
default   running    2d

  4. Instale a telemetria da Apigee:

    Simulação:

    helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

    Instale o gráfico:

    helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

    Para saber se ele está funcionando, confira o estado dele:

    kubectl -n apigee get apigeetelemetry apigee-telemetry

    NAME               STATE     AGE
apigee-telemetry   running   2d

  5. Instale o Apigee Redis:

    Simulação:

    helm upgrade redis apigee-redis/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

    Instale o gráfico:

    helm upgrade redis apigee-redis/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

    Para saber se ele está funcionando, confira o estado dele:

    kubectl -n apigee get apigeeredis default

    NAME      STATE     AGE
default   running   2d

  6. Instale o gerenciador de entrada da Apigee:

    Simulação:

    helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

    Instale o gráfico:

    helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

    Para saber se ele está funcionando, confira a disponibilidade:

    kubectl -n apigee get deployment apigee-ingressgateway-manager

    NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
apigee-ingressgateway-manager   2/2     2            2           2d

  7. Instale a organização da Apigee:

    Simulação:

    helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

    Instale o gráfico:

    helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

    Para saber se ele está funcionando, confira o estado da respectiva organização:

    kubectl -n apigee get apigeeorg

    NAME                      STATE     AGE
apigee-org1-xxxxx          running   2d

  8. Instale o ambiente.

    É preciso instalar um ambiente de cada vez. Especifique o ambiente com --set env=ENV_NAME:

    Simulação:

    helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --atomic \
  --set env=ENV_NAME \
  -f overrides.yaml \
  --dry-run

      ENV_RELEASE_NAME é um nome usado para acompanhar a instalação e os upgrades do gráfico apigee-env. Esse nome precisa ser exclusivo em relação aos outros nomes de versão do Helm na sua instalação. Geralmente, é o mesmo que ENV_NAME. No entanto, se o ambiente tiver o mesmo nome que o grupo, use nomes de versão diferentes para o ambiente e o grupo, por exemplo, dev-env-release e dev-envgroup-release. Para mais informações sobre as versões no Helm, consulte Três conceitos importantes na documentação do Helm.

    Instale o gráfico:

    helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --atomic \
  --set env=ENV_NAME \
  -f overrides.yaml

    Para saber se ele está funcionando, confira o estado do respectivo ambiente:

    kubectl -n apigee get apigeeenv

    NAME                          STATE       AGE   GATEWAYTYPE
apigee-org1-dev-xxx            running     2d
  9. Instale os grupos de ambientes (virtualhosts).
    1. É necessário instalar um grupo de ambiente (virtualhost) por vez. Especifique o grupo de ambientes com --set envgroup=ENV_GROUP_NAME: Repita os seguintes comandos para cada grupo de ambiente mencionado no arquivo overrides.yaml:

      Simulação:

      helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --atomic \
  --set envgroup=ENV_GROUP_NAME \
  -f overrides.yaml \
  --dry-run

        ENV_GROUP_RELEASE_NAME é um nome usado para acompanhar a instalação e os upgrades do gráfico apigee-virtualhosts. Esse nome precisa ser exclusivo em relação aos outros nomes de versão do Helm na instalação. Geralmente, é o mesmo que ENV_GROUP. No entanto, se o grupo de ambiente tiver o mesmo nome de um ambiente na instalação, use nomes de versão diferentes para o grupo e o ambiente, por exemplo, dev-envgroup-release e dev-env-release. Para mais informações sobre as versões no Helm, consulte Três grandes conceitos na documentação do Helm.

      Instale o gráfico:

      helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --atomic \
  --set envgroup=ENV_GROUP_NAME \
  -f overrides.yaml
    2. Verifique o estado da ApigeeRoute (AR).

      A instalação de virtualhosts cria a ApigeeRouteConfig (ARC), que gera internamente a ApigeeRoute (AR) depois que o inspetor da Apigee extrai detalhes relacionados ao grupo de ambientes do plano de controle. Portanto, verifique se o estado de RA correspondente está em execução: 

      kubectl -n apigee get arc

      NAME                                STATE   AGE
apigee-org1-dev-egroup                       2d
       
      kubectl -n apigee get ar

      NAME                                        STATE     AGE
apigee-org1-dev-egroup-xxxxxx                running   2d

GKE com a Identidade da carga de trabalho

Se você estiver instalando a Apigee híbrida no GKE e estiver configurando a Identidade da carga de trabalho para autenticar contas de serviço, na próxima etapa, configure as associações entre as contas de serviço do Kubernetes e do Google para o cluster.

1 2 3 4 5 6 7 8 9 10 11 (PRÓXIMA) Etapa 10: configurar a Identidade da carga de trabalho

Todas as outras instalações

Na próxima etapa, você vai configurar o gateway de entrada da Apigee e implantar um proxy para testar a instalação.

(PRÓXIMA) Etapa 1: expor a entrada da Apigee 2