Passo 3: instale o ASM

Instale o ASM

O Apigee hybrid usa a distribuição do Istio fornecida com o Anthos Service Mesh (ASM). Siga estes passos para instalar o ASM no seu cluster.

Versões do ASM compatíveis

  • Para novas instalações da versão híbrida 1.4.4, instale a versão 1.7.x do ASM.
  • Para atualizações de versões anteriores do híbrido, instale a versão 1.6.x do ASM.

Execute os passos de configuração e configuração do ASM

Para concluir a instalação do ASM, tem de seguir primeiro os passos de configuração e configuração específicos do ASM na documentação do ASM. Em seguida, tem de voltar aqui para concluir a configuração específica do híbrido antes de aplicar a configuração ao cluster.

As instruções para instalar e configurar o ASM são diferentes consoante a sua plataforma. Escolha os passos da sua plataforma abaixo.

GKE

  1. Siga os passos de configuração e configuração do ASM:

  2. Quando tiver concluído os passos de configuração e configuração do ASM, aceda à secção seguinte para concluir os passos de instalação do ASM e de configuração híbrida.

Faça a configuração híbrida final e instale o ASM

Por último, adicione configurações específicas do híbrido ao ficheiro istio-operator.yaml e instale o ASM.

  1. Certifique-se de que está no diretório raiz da instalação do ASM. Por exemplo: 1.7.3-asm.6.
  2. Abra o ficheiro istio-operator.yaml num 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 stanza spec:components no ficheiro istio-operator.yaml abaixo da secção meshConfig: e imediatamente acima de values:, onde reserved_static_ip é um endereço IP que a gateway de entrada do tempo de execução pode usar. Se não tiver um endereço IP estático reservado, para este início rápido, pode omitir a propriedade LoadBalancerIP.

    Texto a copiar

      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 o posicionamento

    Quebras de linha inseridas para facilitar a leitura 

    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. Regresse agora à documentação do ASM que usou anteriormente e conclua a instalação do ASM (instale ou aplique o ficheiro istio-operator.yaml ao cluster). Se estiver no ASM 1.6 e tiver uma escolha, selecione PERMISSIVE mTLS.

GKE On-Prem

Configure e transfira o ASM

Use a documentação do ASM para configurar o seu ambiente e transferir o ASM.

  1. Leia atentamente os passos seguintes antes de começar. Vamos pedir-lhe que execute alguns dos passos indicados na documentação do ASM e, em seguida, volte aqui para concluir a instalação.
  2. Aceda a Instalar o Anthos Service Mesh no local e execute todos os passos do ASM até Criar o espaço de nomes istio-system, pare e aceda à secção seguinte Aplique o manifesto abaixo.

Aplique o manifesto

Quando tiver transferido e descomprimido o ficheiro de instalação do ASM, continue com os seguintes passos:

  1. Certifique-se de que está no diretório do Istio que transferiu e descomprimiu. Por exemplo: 1.7.3-asm.6.
  2. Execute o seguinte comando, em que your_static_ip é um endereço IP estático que o componente de entrada do Istio pode usar. Se não tiver um endereço IP estático reservado, omita 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 último, regresse à documentação do ASM para Verificar os componentes do plano de controlo para validar a instalação.

Personalizar a instalação do ASM

A instalação do ASM que acabou de fazer é uma instalação mínima, suficiente para testar e usar o Apigee hybrid para exemplos de utilização básicos. Para informações sobre como abordar exemplos de utilização mais avançados, como adicionar, remover ou modificar números de porta do equilibrador de carga, consulte Ativar funcionalidades opcionais.

Resumo

Agora, tem o cert-manager e o ASM instalados e está pronto para instalar a ferramenta de linha de comandos do Apigee hybrid na sua máquina local.

AKS

Configure e transfira o ASM

Use a documentação do ASM para configurar o seu ambiente e transferir o ASM.

  1. Leia atentamente os passos seguintes antes de começar. Vamos pedir-lhe que execute alguns dos passos indicados na documentação do ASM e, em seguida, volte aqui para concluir a instalação.
  2. Aceda a Instalar o Anthos Service Mesh em clusters anexados e execute todos os passos do ASM até Criar o espaço de nomes istio-system, pare e aceda à secção seguinte Aplique o manifesto abaixo.

Aplique o manifesto

Quando tiver transferido e descomprimido o ficheiro de instalação do ASM, continue com os seguintes passos:

  1. Certifique-se de que está no diretório do Istio que transferiu e descomprimiu. Por exemplo: 1.7.3-asm.6.
  2. Execute o seguinte comando, em que your_static_ip é um endereço IP estático que o componente de entrada do Istio pode usar. Se não tiver um endereço IP estático reservado, omita 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 último, regresse à documentação do ASM para Verificar os componentes do plano de controlo para validar a instalação.

Personalizar a instalação do ASM

A instalação do ASM que acabou de fazer é uma instalação mínima, suficiente para testar e usar o Apigee hybrid para exemplos de utilização básicos. Para informações sobre como abordar exemplos de utilização mais avançados, como adicionar, remover ou modificar números de porta do equilibrador de carga, consulte Ativar funcionalidades opcionais.

Resumo

Agora, tem o cert-manager e o ASM instalados e está pronto para instalar a ferramenta de linha de comandos do Apigee hybrid na sua máquina local.

GKE no AWS

Configure e transfira o ASM

Use a documentação do ASM para configurar o seu ambiente e transferir o ASM.

  1. Leia atentamente os passos seguintes antes de começar. Vamos pedir-lhe que execute alguns dos passos indicados na documentação do ASM e, em seguida, volte aqui para concluir a instalação.
  2. Aceda a Instalar o Anthos Service Mesh no GKE no AWS e execute todos os passos do ASM até Transferir o ficheiro de instalação, inclusive. Em seguida, pare e aceda à secção seguinte Aplique o manifesto abaixo.

Aplique o manifesto

Quando tiver transferido e descomprimido o ficheiro de instalação do ASM, continue com os seguintes passos:

  1. Certifique-se de que está no diretório do Istio que transferiu e descomprimiu. Por exemplo: 1.7.3-asm.6.
  2. Execute o seguinte comando, em que your_static_ip é um endereço IP estático que o componente de entrada do Istio pode usar. Se não tiver um endereço IP estático reservado, omita 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 último, regresse à documentação do ASM para Verificar os componentes do plano de controlo para validar a instalação.

Personalizar a instalação do ASM

A instalação do ASM que acabou de fazer é uma instalação mínima, suficiente para testar e usar o Apigee hybrid para exemplos de utilização básicos. Para informações sobre como abordar exemplos de utilização mais avançados, como adicionar, remover ou modificar números de porta do equilibrador de carga, consulte Ativar funcionalidades opcionais.

Resumo

Agora, tem o cert-manager e o ASM instalados e está pronto para instalar a ferramenta de linha de comandos do Apigee hybrid na sua máquina local.

EKS

Configure e transfira o ASM

Use a documentação do ASM para configurar o seu ambiente e transferir o ASM.

  1. Leia atentamente os passos seguintes antes de começar. Vamos pedir-lhe que execute alguns dos passos indicados na documentação do ASM e, em seguida, volte aqui para concluir a instalação.
  2. Aceda a Instalar o Anthos Service Mesh em clusters anexados e execute todos os passos do ASM até Criar o espaço de nomes istio-system, pare e aceda à secção seguinte Aplique o manifesto abaixo.

Aplique o manifesto

Quando tiver transferido e descomprimido o ficheiro de instalação do ASM, continue com os seguintes passos:

  1. Certifique-se de que está no diretório do Istio que transferiu e descomprimiu. Por exemplo: 1.7.3-asm.6.
  2. Execute o seguinte comando, em que your_static_ip é um endereço IP estático que o componente de entrada do Istio pode usar. Se não tiver um endereço IP estático reservado, omita 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 último, regresse à documentação do ASM para Verificar os componentes do plano de controlo para validar a instalação.

Personalizar a instalação do ASM

A instalação do ASM que acabou de fazer é uma instalação mínima, suficiente para testar e usar o Apigee hybrid para exemplos de utilização básicos. Para informações sobre como abordar exemplos de utilização mais avançados, como adicionar, remover ou modificar números de porta do equilibrador de carga, consulte Ativar funcionalidades opcionais.

Resumo

Agora, tem o cert-manager e o ASM instalados e está pronto para instalar a ferramenta de linha de comandos do Apigee hybrid na sua máquina local.

Resumo

Agora, tem o cert-manager e o ASM instalados e está pronto para instalar a ferramenta de linha de comandos do Apigee hybrid na sua máquina local.

1 2 3 (NEXT) Passo 4: instale o apigeectl 5 6 7