Etapa 3: instalar o ASM

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:

GKE

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

Verifique se você está no diretório raiz da instalação do ASM. Por exemplo, 1.7.3-asm.6.
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

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

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.

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

Verifique se você está no diretório do Istio de que fez o download e descompactou. Exemplo: 1.7.3-asm.6.
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
```
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.

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

Verifique se você está no diretório do Istio de que fez o download e descompactou. Exemplo: 1.7.3-asm.6.
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
```
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

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.

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

Verifique se você está no diretório do Istio de que fez o download e descompactou. Exemplo: 1.7.3-asm.6.
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
```
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

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.

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

Verifique se você está no diretório do Istio de que fez o download e descompactou. Exemplo: 1.7.3-asm.6.
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
```
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

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