Etapa 3: instalar o ASM

Você está visualizando a versão 1.4 da documentação da Apigee híbrida. This version is end of life. You should upgrade to a newer version. Para mais informações, consulte Versões compatíveis.

Version 1.4 (unsupported)

Versões com suporte:

• v1.12 (mais recente)
• v1.11
• v1.10
• Lista de versões com suporte

Versões sem suporte:

• v1.9
• v1.8
• v1.7
• v1.6
• v1.5
• v1.4
• v1.3
• v1.2
• v1.1

Instalar ASM

A Apigee híbrida usa a distribuição do Istio fornecida com o Anthos Service Mesh (ASM). Siga estas etapas para instalar o ASM no cluster.

Versões compatíveis do ASM

• Para fazer uma nova instalação da versão 1.4.4 da Apigee híbrida, instale a versão 1.7.x do ASM.
• Para fazer upgrade de versões anteriores da Apigee híbrida, instale a versão 1.6.x do ASM.

Realizar etapas de configuração do ASM

Para concluir a instalação do ASM, você precisa seguir as etapas de instalação e configuração específicas na documentação do ASM. Em seguida, volte aqui para concluir a configuração híbrida antes de aplicar a configuração ao cluster.

As instruções para instalar e configurar o ASM variam de acordo com a plataforma. Escolha abaixo as etapas para a sua plataforma:

A configuração a seguir pressupõe que os clientes serão ativados para SNI por padrão. Se não estiverem, consulte as instruções para Ativar clientes não SNI e HTTP.

GKE

1. Siga as etapas de configuração do ASM:
   Importante: ao seguir a documentação do ASM, não instale ou aplique o arquivo de configuração YAML istio-operator.yaml quando for instruído. Nesse momento, você precisa retornar a esta página para editar o arquivo com outras configurações específicas do ambiente híbrido antes de instalar/aplicar a configuração.
   • Se for uma nova instalação da Apigee híbrida, instale a versão 1.7.x do ASM. Acesse: Nova instalação.
   • Se você estiver fazendo upgrade de uma versão anterior da Apigee híbrida, use o ASM 1.6.x. Acesse: Introdução à instalação e à migração.

2. Depois de concluir as etapas de instalação e configuração do ASM, vá para a próxima seção para concluir a configuração híbrida e as etapas de instalação do ASM.

Realizar a configuração híbrida final e instalar o ASM

Por fim, adicione configurações específicas do ambiente híbrido ao arquivo istio-operator.yaml e instale o ASM.

1. Verifique se você está no diretório raiz da instalação do ASM. Por exemplo, 1.7.3-asm.6.
2. Abra o arquivo istio-operator.yaml em um editor.
   • No ASM 1.7.x: ./asm/istio/istio-operator.yaml
   • No ASM 1.6.x: ./asm/cluster/istio-operator.yaml
3. Adicione (ou atualize) a estrofe spec:components no arquivo istio-operator.yaml abaixo da seção meshConfig: e imediatamente acima de values:, em que reserved_static_ip é um endereço IP que seu ambiente de execução do gateway de entrada pode usar. Se você não tiver um endereço IP estático reservado para este início rápido, então não adicione LoadBalancerIP.

   Texto a ser copiado

     components:
       ingressGateways:
       - name: istio-ingressgateway
         enabled: true
         k8s:
           service:
             type: LoadBalancer
             loadBalancerIP: static_ip # If you do not have a reserved static IP, leave this out.
             ports:
             - name: status-port
               port: 15021 # for ASM 1.7.x and above, else 15020
               targetPort: 15021 # for ASM 1.7.x and above, else 15020
             - name: http2
               port: 80
               targetPort: 8080
             - name: https
               port: 443
               targetPort: 8443
   

   Exemplo que mostra a posição

   Quebras de linha inseridas para legibilidade

   apiVersion: install.istio.io/v1alpha1
   kind: IstioOperator
   metadata:
     clusterName: "hybrid-example/us-central1/example-cluster" # {"$ref":"#/definitions/io.k8s.cli.substitutions.cluster-name"}
   spec:
     profile: asm
     hub: gcr.io/gke-release/asm # {"$ref":"#/definitions/io.k8s.cli.setters.anthos.servicemesh.hub"}
     tag: 1.5.7-asm.0 # {"$ref":"#/definitions/io.k8s.cli.setters.anthos.servicemesh.tag"}
     meshConfig:
       defaultConfig:
         proxyMetadata:
           GCP_METADATA: "hybrid-example|123456789123|example-cluster|us-central1" #
             {"$ref":"#/definitions/io.k8s.cli.substitutions.gke-metadata"}
   
     components:
       pilot:
         k8s:
           hpaSpec:
             maxReplicas: 2
       ingressGateways:
       - name: istio-ingressgateway
         enabled: true
         k8s:
           service:
             type: LoadBalancer
             loadBalancerIP: 123.234.56.78
             ports:
             - name: status-port
               port: 15021 # for ASM 1.7.x and above, else 15020
               targetPort: 15021 # for ASM 1.7.x and above, else 15020
             - name: http2
               port: 80
               targetPort: 8080
             - name: https
               port: 443
               targetPort: 8443
           hpaSpec:
             maxReplicas: 2
     values:
       .
       .
       .

4. Retorne agora à documentação do ASM usada anteriormente e conclua a instalação do ASM (instale ou aplique o arquivo istio-operator.yaml ao cluster). Se você estiver no ASM 1.6 e tiver uma opção, escolha PERMISSIVE mTLS.
   Observação: se você estiver no ASM 1.6, recomendamos usar o comando asmctl validate para validar a configuração e a integridade dos componentes instalados. Esse comando é descrito na seção da documentação do ASM sobre como validar a instalação. Esse comando só é válido se você estiver no ASM 1.6.

GKE On-Prem

Configure e faça o download do ASM

Use a documentação do ASM para configurar o ambiente e fazer o download do ASM.

1. Leia as etapas a seguir com atenção antes de começar. Solicitaremos que você realize algumas das etapas listadas na documentação do ASM, depois volte aqui para concluir a instalação.
2. Acesse Como instalar o Anthos Service Mesh no local e execute todas as etapas do ASM, incluindo Criar o namespace istio-system, em seguida, pare e vá para a próxima seção Aplicar o manifesto abaixo.
   Importante: depois de concluir as etapas na seção Criar o namespaceistio-system, pare e continue com as etapas listadas na próxima seção. Recomendamos que você espere a aplicação do arquivo de manifesto até que seja instruído abaixo.

Aplicar o manifesto

Depois de fazer o download e descompactar o arquivo de instalação do ASM, continue com as seguintes etapas:

1. Verifique se você está no diretório do Istio de que fez o download e descompactou. Exemplo: 1.7.3-asm.6.
2. Execute o comando a seguir, em que your_static_ip é um endereço IP estático que pode ser usado pelo componente de entrada do Istio. Se você não tiver um endereço IP estático reservado, não adicione a linha --set values.gateways.istio-ingressgateway.loadBalancerIP:

   ./bin/istioctl install --set profile=asm-multicloud \
    --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP

3. Por fim, volte à documentação do ASM para Verificar os componentes do plano de controle para validar a instalação.

Como personalizar a instalação do ASM

A instalação do ASM que você acabou de executar é uma instalação mínima, suficiente para testar e usar a Apigee híbrida para casos de uso básicos. Para informações sobre como lidar com casos de uso mais avançados, como adicionar, remover ou modificar números de porta do balanceador de carga, consulte Como ativar recursos opcionais.

Resumo

Agora, o gerenciador de certificados e o ASM estão instalados e é possível instalar a ferramenta de linha de comando da Apigee híbrida na máquina local.

AKS

Configure e faça o download do ASM

Use a documentação do ASM para configurar o ambiente e fazer o download do ASM.

1. Leia as etapas a seguir com atenção antes de começar. Solicitaremos que você realize algumas das etapas listadas na documentação do ASM, depois volte aqui para concluir a instalação.
2. Acesse Como instalar o Anthos Service Mesh em clusters anexados e execute todas as etapas ASM incluindo Criar o namespace istio-system. Em seguida, pare e vá para a próxima seção Aplicar o manifesto abaixo.
   Importante: depois de concluir as etapas na seção Criar o namespace istio-system, pare e continue com as etapas listadas na próxima seção. Recomendamos que você espere a aplicação do arquivo de manifesto até que seja instruído abaixo.

Aplicar o manifesto

Depois de fazer o download e descompactar o arquivo de instalação do ASM, continue com as seguintes etapas:

1. Verifique se você está no diretório do Istio de que fez o download e descompactou. Exemplo: 1.7.3-asm.6.
2. Execute o comando a seguir, em que your_static_ip é um endereço IP estático que pode ser usado pelo componente de entrada do Istio. Se você não tiver um endereço IP estático reservado, não adicione a linha --set values.gateways.istio-ingressgateway.loadBalancerIP:

   ./bin/istioctl install --set profile=asm-multicloud \
    --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP

3. Por fim, volte à documentação do ASM para Verificar os componentes do plano de controle para validar a instalação.

Como personalizar a instalação do ASM

A instalação do ASM que você acabou de executar é uma instalação mínima, suficiente para testar e usar a Apigee híbrida para casos de uso básicos. Para informações sobre como lidar com casos de uso mais avançados, como adicionar, remover ou modificar números de porta do balanceador de carga, consulte Como ativar recursos opcionais.

Resumo

Agora, o gerenciador de certificados e o ASM estão instalados e é possível instalar a ferramenta de linha de comando da Apigee híbrida na máquina local.

GKE na AWS

Configure e faça o download do ASM

Use a documentação do ASM para configurar o ambiente e fazer o download do ASM.

1. Leia as etapas a seguir com atenção antes de começar. Solicitaremos que você realize algumas das etapas listadas na documentação do ASM, depois volte aqui para concluir a instalação.
2. Acesse Como instalar o Anthos Service Mesh no GKE na AWS e execute todas as etapas ASM, incluindo Fazer o download do arquivo de instalação. Em seguida, pare e vá para a próxima seção abaixo Aplicar o manifesto.
   IMPORTANTE: depois de concluir as etapas na seção Fazer o download do arquivo de instalação, pare e continue com as etapas listadas na próxima seção. Recomendamos que você espere a aplicação do arquivo de manifesto até que seja instruído abaixo.

Aplicar o manifesto

Depois de fazer o download e descompactar o arquivo de instalação do ASM, continue com as seguintes etapas:

1. Verifique se você está no diretório do Istio de que fez o download e descompactou. Exemplo: 1.7.3-asm.6.
2. Execute o comando a seguir, em que your_static_ip é um endereço IP estático que pode ser usado pelo componente de entrada do Istio. Se você não tiver um endereço IP estático reservado, não adicione a linha --set values.gateways.istio-ingressgateway.loadBalancerIP:

   ./bin/istioctl install --set profile=asm-multicloud \
    --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP

3. Por fim, volte à documentação do ASM para Verificar os componentes do plano de controle para validar a instalação.

Como personalizar a instalação do ASM

A instalação do ASM que você acabou de executar é uma instalação mínima, suficiente para testar e usar a Apigee híbrida para casos de uso básicos. Para informações sobre como lidar com casos de uso mais avançados, como adicionar, remover ou modificar números de porta do balanceador de carga, consulte Como ativar recursos opcionais.

Resumo

Agora, o gerenciador de certificados e o ASM estão instalados e é possível instalar a ferramenta de linha de comando da Apigee híbrida na máquina local.

EKS

Configure e faça o download do ASM

Use a documentação do ASM para configurar o ambiente e fazer o download do ASM.

1. Leia as etapas a seguir com atenção antes de começar. Solicitaremos que você realize algumas das etapas listadas na documentação do ASM, depois volte aqui para concluir a instalação.
2. Acesse Como instalar o Anthos Service Mesh em clusters anexados e execute todas as etapas ASM incluindo Criar o namespace istio-system. Em seguida, pare e vá para a próxima seção Aplicar o manifesto abaixo.
   Importante: depois de concluir as etapas na seção Criar o namespace istio-system, pare e continue com as etapas listadas na próxima seção. Recomendamos que você espere a aplicação do arquivo de manifesto até que seja instruído abaixo.

Aplicar o manifesto

Depois de fazer o download e descompactar o arquivo de instalação do ASM, continue com as seguintes etapas:

1. Verifique se você está no diretório do Istio de que fez o download e descompactou. Exemplo: 1.7.3-asm.6.
2. Execute o comando a seguir, em que your_static_ip é um endereço IP estático que pode ser usado pelo componente de entrada do Istio. Se você não tiver um endereço IP estático reservado, não adicione a linha --set values.gateways.istio-ingressgateway.loadBalancerIP:

   ./bin/istioctl install --set profile=asm-multicloud \
    --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP

3. Por fim, volte à documentação do ASM para Verificar os componentes do plano de controle para validar a instalação.

Como personalizar a instalação do ASM

A instalação do ASM que você acabou de executar é uma instalação mínima, suficiente para testar e usar a Apigee híbrida para casos de uso básicos. Para informações sobre como lidar com casos de uso mais avançados, como adicionar, remover ou modificar números de porta do balanceador de carga, consulte Como ativar recursos opcionais.

Resumo

Agora, o gerenciador de certificados e o ASM estão instalados e é possível instalar a ferramenta de linha de comando da Apigee híbrida na máquina local.

Resumo

Agora, o gerenciador de certificados e o ASM estão instalados e é possível instalar a ferramenta de linha de comando da Apigee híbrida na máquina local.

1 2 3 (A SEGUIR) Etapa 4: instalar a apigeectl 5 6 7