Esta página foi traduzida pela API Cloud Translation.

Atualizar o Apigee Hybrid para a versão 1.9

Este procedimento abrange a atualização da versão 1.8.x do Apigee Hybrid para a versão 1.9.4 do Apigee Hybrid e das versões anteriores do Hybrid 1.9.x para a versão 1.9.4.

Use os mesmos procedimentos para atualizações de versões secundárias (por exemplo, da versão 1.8 para a 1.9) e para atualizações de lançamentos de patches (por exemplo, da versão 1.9.0 para a 1.9.4).

Se estiver a atualizar a partir da versão 1.7 ou anterior do Apigee Hybrid, tem de atualizar primeiro para a versão 1.8 antes de atualizar para a versão 1.9.4. Consulte as instruções para atualizar o Apigee Hybrid para a versão 1.8.

A partir da versão 1.9.0, o Apigee hybrid só suporta o gateway de entrada do Apigee como a camada de entrada.

Vista geral da atualização para a versão 1.9.4

A atualização para a versão 1.9 do Apigee Hybrid pode exigir tempo de inatividade.

Quando atualizar o controlador do Apigee para a versão 1.9.4, todas as implementações do Apigee são reiniciadas de forma gradual. Para minimizar o tempo de inatividade em ambientes híbridos de produção durante um reinício contínuo, certifique-se de que está a executar, pelo menos, dois clusters (na mesma região ou num centro de dados diferente). Desvie todo o tráfego de produção para um único cluster e coloque o cluster que está prestes a atualizar offline. Em seguida, avance com o processo de atualização. Repita o processo para cada cluster.

A Apigee recomenda que atualize todos os clusters assim que possível para reduzir as probabilidades de impacto na produção. Não existe um limite de tempo para quando todos os clusters restantes têm de ser atualizados depois de o primeiro ser atualizado. No entanto, até que todos os clusters restantes sejam atualizados, as seguintes operações serão afetadas:

A cópia de segurança e o restauro do Cassandra não podem funcionar com versões misturadas. Por exemplo, não é possível usar uma cópia de segurança do Hybrid 1.8 para restaurar uma instância do Hybrid 1.9.
O streaming de dados do Cassandra não funciona entre versões híbridas misturadas. Por conseguinte, os seus clusters do Cassandra não podem ser dimensionados horizontalmente.
A expansão e a desativação de regiões serão afetadas, uma vez que estas operações dependem do streaming de dados do Cassandra.

Os procedimentos para atualizar o Apigee hybrid estão organizados nas seguintes secções:

Prepare-se para a atualização.
Instale a versão 1.9.4 do tempo de execução híbrido.

Pré-requisitos

Estas instruções de atualização pressupõem que tem a versão 1.8.x do Apigee hybrid instalada e quer atualizá-la para a versão 1.9.4. Se estiver a fazer a atualização a partir de uma versão anterior, consulte as instruções para atualizar o Apigee Hybrid para a versão 1.8.
Na versão 1.8 do Apigee Hybrid, introduzimos o gateway de entrada do Apigee como uma camada de entrada alternativa para o Anthos Service Mesh. A partir da versão 1.9.0, o Apigee hybrid requer a utilização do gateway de entrada do Apigee e já não suporta a utilização do Anthos Service Mesh para a entrada. Se a instalação a partir da qual está a fazer a atualização usar o Anthos Service Mesh, primeiro tem de migrar para a utilização do gateway de entrada do Apigee antes de fazer a atualização para a versão 1.9.4.
O gateway de entrada do Apigee usa um pequeno subconjunto de funcionalidades do Anthos Service Mesh para o gateway de entrada. A gestão e a atualização dessas funcionalidades são processadas automaticamente pelo Apigee hybrid. Por conseguinte, não precisa de conhecimentos especializados do Anthos Service Mesh para instalar, atualizar e gerir o gateway de entrada híbrido do Apigee.

Consulte o artigo Migrar para o gateway de entrada do Apigee na documentação do híbrido v1.8 para ver instruções.

Prepare-se para atualizar para a versão 1.9

Faça uma cópia de segurança da sua instalação híbrida (recomendado)

Estas instruções usam a variável de ambiente APIGEECTL_HOME para o diretório no seu sistema de ficheiros onde instalou o apigeectl. Se necessário, altere o diretório para o diretório apigeectl e defina a variável com o seguinte comando:
Linux
```
export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME
```
Mac OS
```
export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME
```
Windows
```
set APIGEECTL_HOME=%CD%
echo %APIGEECTL_HOME%
```
Faça uma cópia de segurança do diretório $APIGEECTL_HOME/ da versão 1.8. Por exemplo:
```
tar -czvf $APIGEECTL_HOME/../apigeectl-v1.8-backup.tar.gz $APIGEECTL_HOME
```
Faça uma cópia de segurança da base de dados Cassandra seguindo as instruções em Cópia de segurança e recuperação do Cassandra.

Adicione a função Agente do Cloud Trace à conta de serviço do tempo de execução do Apigee. (Opcional)

Opcional: se planeia usar o Cloud Trace e ainda não adicionou a função Cloud Trace Agent à sua instalação híbrida v1.8, certifique-se de que a conta de serviço dos seus serviços de tempo de execução do Apigee tem a função do Google Cloud IAM Cloud Trace Agent (roles/cloudtrace.agent).

Para ambientes de produção, a conta de serviço de tempo de execução é apigee-runtime. Para ambientes de não produção, a conta de serviço de tempo de execução é apigee-non-prod.

Pode adicionar a função na IU de Cloud Console > IAM & Admin > Contas de serviço ou com os seguintes comandos:

Obtenha o endereço de email da sua conta de serviço com o seguinte comando:
Produção
```
gcloud iam service-accounts list --filter "apigee-runtime"
```
Se o endereço de email corresponder ao padrão apigee-runtime@$ORG_NAME.iam.gserviceaccount.com, pode usar esse padrão no passo seguinte.
Não produção
```
gcloud iam service-accounts list --filter "apigee-non-prod"
```
Se corresponder ao padrão apigee-non-prod@$ORG_NAME.iam.gserviceaccount.com, pode usar esse padrão no passo seguinte.

Atribua a função Agente do Cloud Trace à conta de serviço:

Produção

gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:apigee-runtime@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

Não produção

gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:apigee-non-prod@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

Exemplo

gcloud projects add-iam-policy-binding hybrid-example-project \
    --member="serviceAccount:apigee-runtime@hybrid-example-project.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

Onde: $PROJECT_ID é o nome do projeto do Google Cloud onde o Apigee hybrid está instalado.

Nota: se a sua instalação usar um nome personalizado para a conta de serviço, substitua esse nome por apigee-runtime ou apigee-non-prod no comando.

Instale o gateway de entrada do Apigee se a sua instalação usar o Anthos Service Mesh

A partir da versão 1.9, o Apigee hybrid já não suporta a utilização do Anthos Service Mesh para a entrada. Se a sua instalação híbrida estiver a usar o Anthos Service Mesh, tem de migrar a instalação atual para o gateway de entrada do Apigee antes de instalar a versão híbrida 1.9.

Adicione a propriedade ingressGateways ao ficheiro de substituições.
Sintaxe
```
  ingressGateways:
  - name: INGRESS_NAME
    replicaCountMin: REPLICAS_MIN
    replicaCountMax: REPLICAS_MAX
    resources:
      requests:
        cpu: CPU_COUNT_REQ
        memory: MEMORY_REQ
      limits:
        cpu: CPU_COUNT_LIMIT
        memory: MEMORY_LIMIT
    svcAnnotations:  # optional.
      SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
    svcLoadBalancerIP: SVC_LOAD_BALANCER_IP # optional
```
Exemplo
```
  ingressGateways:
  - name: prod1
    replicaCountMin: 2
    replicaCountMax: 100
    resources:
      requests:
        cpu: 1
        memory: 1Gi
      limits:
        cpu: 2
        memory: 2Gi
    svcAnnotations:  # optional. See Known issue 243599452.
      networking.gke.io/load-balancer-type: "Internal"
    svcLoadBalancerIP: 198.252.0.123 
```
- INGRESS_NAME é o nome da implementação de entrada. Pode ser qualquer nome que cumpra os seguintes requisitos:
  - Ter um comprimento máximo de 17 carateres
  - Contêm apenas carateres alfanuméricos minúsculos, "-" ou "."
  - Começar com um caráter alfanumérico
  - Terminar com um caráter alfanumérico
  Consulte ingressGateways[].name na referência da propriedade de configuração.
- REPLICAS_MIN e REPLICAS_MAX são as quantidades mínimas e máximas de réplicas para o gateway de entrada do Apigee na sua instalação. Para mais informações e definições predefinidas, consulte ingressGateways[].replicaCountMin e ingressGateways[].replicaCountMax na referência da propriedade de configuração.
- CPU_COUNT_REQ e MEMORY_REQ são o pedido de CPU e memória para cada réplica do gateway de entrada do Apigee na sua instalação.
  Defina estas propriedades se as tiver definido anteriormente para o gateway de entrada do Anthos Service Mesh, por exemplo, no seu ficheiro overlay.yaml.
  
  Para mais informações e definições predefinidas, consulte ingressGateways[].resources.requests.cpu e ingressGateways[].resources.requests.memory na referência da propriedade de configuração.
- CPU_COUNT_LIMIT e MEMORY_LIMIT são os limites máximos de CPU e memória para cada réplica do gateway de entrada do Apigee na sua instalação.
  Defina estas propriedades se as tiver definido anteriormente para o gateway de entrada do Anthos Service Mesh, por exemplo, no seu ficheiro overlay.yaml.
  
  Para mais informações e definições predefinidas, consulte ingressGateways[].resources.limits.cpu e ingressGateways[].resources.limits.memory na referência da propriedade de configuração.
- SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (opcional):
  Nota: o campo ingressGateways[].svcAnnotations em overrides.yaml não está a funcionar como esperado. Consulte o problema conhecido 243599452
  
  Este é um par de chave-valor que fornece anotações para o seu serviço de entrada predefinido. As anotações são usadas pela sua plataforma na nuvem para ajudar a configurar a instalação híbrida, por exemplo, definindo o tipo de balanceador de carga como interno ou externo. Por exemplo:
```
ingressGateways:
    svcAnnotations:
      networking.gke.io/load-balancer-type: "Internal"
```
  As anotações variam de plataforma para plataforma. Consulte a documentação da plataforma para ver as anotações obrigatórias e sugeridas.
  
  Nota: não precisa de definir Annotations se estiver a criar o seu próprio serviço Kubernetes para a implementação de entrada, conforme documentado no artigo Exponha o gateway de entrada do Apigee.
  Consulte ingressGateways[].svcAnnotations na referência da propriedade de configuração.
- SVC_LOAD_BALANCER_IP (opcional) Permite-lhe atribuir um endereço IP estático ao seu equilibrador de carga. Em plataformas que suportam a especificação do endereço IP do balanceador de carga, o balanceador de carga é criado com este endereço IP. Nas plataformas que não lhe permitem especificar o endereço IP do balanceador de carga, esta propriedade é ignorada.
  Se não tiver um endereço IP estático atribuído ao seu equilibrador de carga, exclua esta propriedade do ficheiro de substituições.
  
  Aviso: certifique-se de que não especifica o mesmo endereço IP que o istio-ingressgateway atual. Isto pode causar problemas enquanto esse serviço ainda estiver no cluster.
  
  Nota: não precisa de definir LoadBalancerIP se estiver a criar o seu próprio serviço Kubernetes para a implementação de entrada, conforme documentado no artigo Exponha o gateway de entrada do Apigee.
  Consulte ingressGateways[].svcLoadBalancerIP na referência da propriedade de configuração.
Aplique as alterações para instalar o gateway de entrada do Apigee com os seguintes comandos:
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml
```
Exponha a gateway de entrada do Apigee. Siga os procedimentos em Exponha o gateway de entrada do Apigee.
Teste o novo gateway de entrada chamando um proxy. Idealmente, teste todos os proxies cruciais que tem atualmente implementados.
Para mudar o tráfego, atualize os seus registos de DNS para direcionarem para o endereço IP do novo gateway de entrada do Apigee. Consoante o seu fornecedor de DNS, pode conseguir mudar gradualmente o tráfego para o novo ponto final.
Dica: pode encontrar o endereço IP externo do gateway de entrada do Apigee com o seguinte comando:
```
kubectl get svc -n apigee -l app=apigee-ingressgateway
```
O resultado deve ter um aspeto semelhante ao seguinte:
```
NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h
```
Certifique-se de que todo o tráfego de tempo de execução está a funcionar monitorizando os painéis de controlo. Só avance para o passo seguinte se tudo estiver a funcionar conforme esperado. Certifique-se de que não passa tráfego pelo gateway de entrada antigo (Anthos Service Mesh), uma vez que a atualização de DNS pode demorar a propagar-se devido ao armazenamento em cache de DNS.
Para impedir que o Apigee forneça configuração ao Anthos Service Mesh, siga os passos em Pare de fornecer configuração ao ASM no guia de gestão do gateway de entrada do Apigee.
Teste novamente e monitorize o tráfego de proxy da API.
Siga as instruções na documentação do Anthos Service Mesh para desinstalar o Anthos Service Mesh do cluster.

Instale o runtime híbrido 1.9.4

Certifique-se de que está no diretório base híbrido (o diretório principal do diretório onde se encontra o ficheiro executável apigeectl):
```
cd $APIGEECTL_HOME/..
```

Transfira o pacote de lançamento para o seu sistema operativo através do seguinte comando. Certifique-se de que seleciona a sua plataforma na tabela seguinte:

Linux

Linux de 64 bits:

curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.9.4/apigeectl_linux_64.tar.gz

Mac OS

Mac 64 bits:

curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.9.4/apigeectl_mac_64.tar.gz

Windows

Windows de 64 bits:

curl -LO ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.9.4/apigeectl_windows_64.zip

Mude o nome do diretório apigeectl/ atual para um nome de diretório de cópia de segurança. Por exemplo:

Linux

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.8/

Mac OS

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.8/

Windows

rename %APIGEECTL_HOME% %APIGEECTL_HOME%-v1.8

Extraia o conteúdo do ficheiro gzip transferido para o diretório de base híbrido. O diretório base híbrido é o diretório onde se encontra o diretório apigeectl-v1.8 com o nome alterado:
Linux
```
tar xvzf filename.tar.gz -C ./
```
Mac OS
```
tar xvzf filename.tar.gz -C ./
```
Windows
```
tar xvzf filename.zip -C ./
```
Por predefinição, o conteúdo do TAR é expandido para um diretório com a versão e a plataforma no respetivo nome. Por exemplo: ./apigeectl_1.9.4-xxxxxxx_linux_64. Mude o nome desse diretório para apigeectl através do seguinte comando:
Linux
```
mv apigeectl_1.9.4-xxxxxxx_linux_64 apigeectl
```
Mac OS
```
mv apigeectl_1.9.4-xxxxxxx_mac_64 apigeectl
```
Windows
```
rename apigeectl_1.9.4-xxxxxxx_windows_64 apigeectl
```
Altere para o diretório apigeectl:
```
cd ./apigeectl
```
Este diretório é o apigeectldiretório inicial. É onde se encontra o comando executável apigeectl.
Estas instruções usam a variável de ambiente $APIGEECTL_HOME para o diretório no seu sistema de ficheiros onde o utilitário apigeectl está instalado. Se necessário, altere o diretório para o diretório apigeectl e defina a variável com o seguinte comando:
Linux
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
Mac OS
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
Windows
```
set APIGEECTL_HOME=%CD%
```
```
echo %APIGEECTL_HOME%
```
Valide a versão do apigeectl com o comando version:
```
./apigeectl version
```
```
Version: 1.9.4
```
Mova-se para o diretório hybrid-base-directory/hybrid-files. O diretório hybrid-files é onde se encontram os ficheiros de configuração, como o ficheiro de substituições, os certificados e as contas de serviço. Por exemplo:
```
cd $APIGEECTL_HOME/../hybrid-files
```
Verifique se kubectl está definido para o contexto correto através do seguinte comando. O contexto atual deve ser definido para o cluster no qual está a atualizar o Apigee Hybrid.
```
kubectl config get-contexts | grep \*
```
No diretório hybrid-files:
1. Atualize os seguintes links simbólicos para $APIGEECTL_HOME. Estes links permitem-lhe executar o comando apigeectl recém-instalado a partir do diretório hybrid-files:
```
ln -nfs $APIGEECTL_HOME/tools tools
ln -nfs $APIGEECTL_HOME/config config
ln -nfs $APIGEECTL_HOME/templates templates
ln -nfs $APIGEECTL_HOME/plugins plugins
```
2. Para verificar se os links simbólicos foram criados corretamente, execute o seguinte comando e certifique-se de que os caminhos dos links apontam para as localizações corretas:
```
ls -l | grep ^l
```
Faça uma inicialização de teste para verificar se existem erros:
```
${APIGEECTL_HOME}/apigeectl init -f OVERRIDES_FILE --dry-run=client
```
Onde OVERRIDES_FILE é o nome do ficheiro de substituições, por exemplo, ./overrides/overrides.yaml.

Sugestão: pode substituir OVERRIDES_FILE no exemplo de código acima pelo nome e caminho do seu ficheiro de substituições. Todas as instâncias nesta página serão substituídas.
Se não existirem erros, inicialize o híbrido 1.9.4:
```
$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE
```
Nota: apigeectl instala e configura o gateway de entrada do Apigee quando executa apigeectl init.
Verifique o estado de inicialização:
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
Se for bem-sucedido, o resultado indica: All containers ready.
```
kubectl describe apigeeds -n apigee
```
No resultado, procure State: running.
Verifique se existem erros com uma execução de teste do comando apply através do sinalizador --dry-run:
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --dry-run=client
```
Se não houver erros, aplique as substituições. Selecione e siga as instruções para ambientes de produção ou ambientes de não produção, consoante a sua instalação.
Produção

Para ambientes de produção, atualize cada componente híbrido individualmente e verifique o estado do componente atualizado antes de avançar para o componente seguinte.
1. Certifique-se de que está no diretório hybrid-files.
2. Aplique as substituições para atualizar o Cassandra:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --datastore
3. Conclusão da verificação:
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
  Sugestão: se o comando check-ready falhar, pode obter mais informações sobre os seus pods com:
  kubectl -n NAMESPACE get pods
  
  Onde NAMESPACE é o espaço de nomes híbrido do Apigee.
  Avance para o passo seguinte apenas quando os pods estiverem prontos.
4. Aplique as substituições para atualizar os componentes de telemetria e verifique a conclusão:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --telemetry
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
5. Apresente os componentes do Redis:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --redis
6. Aplique as substituições para atualizar os componentes ao nível da organização (MART, Watcher e Apigee Connect) e verifique a conclusão:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --org
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
7. Aplique as substituições para atualizar os seus ambientes. Tem 2 opções:
  - Ambiente por ambiente: aplique as substituições a um ambiente de cada vez e verifique a conclusão. Repita este passo para cada ambiente:
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --env ENV_NAME
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    
    Em que ENV_NAME é o nome do ambiente que está a atualizar.
  - Todos os ambientes ao mesmo tempo: aplique as substituições a todos os ambientes de uma só vez e verifique a conclusão:
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --all-envs
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
8. Aplique as substituições para atualizar os componentes virtualhosts e verifique a conclusão:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --settings virtualhosts
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
Não prod

Na maioria dos ambientes de não produção, demonstração ou experimentais, pode aplicar as substituições a todos os componentes de uma só vez. Se o seu ambiente de não produção for grande e complexo ou imitar de perto um ambiente de produção, é recomendável usar as instruções para atualizar ambientes de produção.
1. Certifique-se de que está no diretório hybrid-files.
2. $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE
3. Verifique o estado:
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

Instale a app `1.9.4-hotfix.1`

Siga estes passos para instalar a versão de correção rápida 1.9.4-hotfix.1:

Antes de seguir estes passos, tem de ter a versão 1.9.4 ou posterior do Apigee Hybrid. Se não tiver a versão 1.9.4 ou posterior, faça uma atualização para a versão 1.9.4 antes de continuar.
Abra o ficheiro overrides.yaml.

Na secção istiod, altere a versão da etiqueta da imagem (se presente) para a versão 1.17.7. Por exemplo:

istiod:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-istiod"
    tag: "1.17.7-asm.0-distroless"

Consoante a forma como optou por instalar o Apigee hybrid, pode ter uma secção ingressGateway ou ingressGateways. Localize a estrofe que aparece no ficheiro de substituições e altere a versão da etiqueta de imagem (se presente) para a versão 1.17.7. Por exemplo, se tiver uma secção ingressGateway:

ingressGateway:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
    tag: "1.17.7-asm.0-distroless"

Ou, se tiver uma secção ingressGateways:

ingressGateways:
  - name: gateway1
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.7-asm.0-distroless"
    ...
  - name: gateway2
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.7-asm.0-distroless"
    ...

Guarde o ficheiro.

Execute o seguinte comando para inicializar o componente istiod:

$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE

$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

Execute o seguinte comando para aplicar alterações aos componentes de entrada do Apigee. Se tiver mais do que uma organização, repita este comando para cada uma:
```
$APIGEECTL_HOME/apigeectl apply --org -f OVERRIDES_FILE
```
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```

Valide o estado dos seus pods:

kubectl get pods -n YOUR_APIGEE_NAMESPACE

Atualize a versão do Kubernetes

Atualize a sua plataforma Kubernetes para as versões suportadas pelo híbrido 1.9. Siga a documentação da sua plataforma se precisar de ajuda.

Clique para expandir uma lista de plataformas suportadas

	Versões do Apigee Hybrid
Plataformas	1.6 ⁽³⁾	1.7 ⁽³⁾	1.8 ⁽³⁾	1.9	1.10
Anthos (Google Cloud – GKE)	1.19.x 1.20.x 1.21.x	1.20.x 1.21.x 1.22.x ^{(≥ 1.7.2)} 1.23.x ^{(≥ 1.7.2)}	1.21.x ^{(≤ 1.8.3)} 1.22.x ^{(≤ 1.8.3)} 1.23.x ^{(≤ 1.8.4)} 1.24.x ^{(≥ 1.8.4)} 1.25.x ^{(≥ 1.8.4)}	1.23.x 1.24.x 1.25.x 1.26.x ^{(≥ 1.9.2)}	1.24.x 1.25.x 1.26.x
Anthos (AWS)	1.7.x 1.8.x 1.9.3+ 1.10.x	1.9.x 1.10.x 1.12.x ^{(≥ 1.7.2)}	1.10.x 1.11.x 1.12.x 1.13.x 1.25⁽¹³⁾	1.12.x 1.13.x 1.25⁽¹³⁾	1.13.x 1.25⁽¹³⁾ 1.26⁽¹³⁾
Anthos (Azure)	1.8.x	1.9.x 1.10.x 1.12.x ^{(≥ 1.7.2)}	1.10.x 1.11.x 1.12.x 1.13.x 1.14.x	1.12.x 1.13.x 1.14.x	1.13.x 1.14.x 1.15.x
Anthos (no local – VMware)⁽¹⁾	1.7.x 1.8.x 1.9.3+ 1.10.x	1.9.x ⁽⁴⁾ 1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ ^{(≥ 1.7.2)} 1.12.x ⁽⁴⁾ ^{(≥ 1.7.2)}	1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ 1.12.x ⁽⁴⁾ ⁽⁵⁾ 1.13.x ⁽⁵⁾ 1.14.x ⁽⁵⁾ 1.15.x	1.12.x ⁽⁴⁾ 1.13.x 1.14.x 1.15.x	1.13.x 1.14.x 1.15.x 1.16.x
Anthos (bare metal)⁽¹⁾	1.7.x 1.8.2+ 1.9.3+ 1.10.x	1.9.x ⁽⁴⁾ 1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ ^{(≥ 1.7.2)} 1.12.x ⁽⁴⁾ ^{(≥ 1.7.2)}	1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ 1.12.x ⁽⁴⁾ ⁽⁵⁾ 1.13.x ⁽⁵⁾ 1.14.x ⁽⁵⁾ 1.15.x	1.12.x ⁽⁴⁾ 1.13.x 1.14.x 1.15.x	1.13.x 1.14.x 1.15.x 1.16.x
EKS⁽⁷⁾	1.19.x 1.20.x 1.21.x	1.21.x 1.22.x ^{(≥ 1.7.2)} 1.23.x ^{(≥ 1.7.2)}	1.22.x ^{(≤ 1.8.3)} 1.23.x ^{(≤ 1.8.4)} 1.24.x ^{(≥ 1.8.4)} 1.25.x ^{(≥ 1.8.4)}	1.23.x 1.24.x 1.25.x 1.26.x ^{(≥ 1.9.2)}	1.24.x 1.25.x 1.26.x
AKS⁽⁷⁾	1.19.x 1.20.x 1.21.x	1.21.x 1.22.x ^{(≥ 1.7.2)} 1.23.x ^{(≥ 1.7.2)}	1.22.x ^{(≤ 1.8.3)} 1.23.x ^{(≤ 1.8.4)} 1.24.x ^{(≥ 1.8.4)} 1.25.x ^{(≥ 1.8.4)}	1.23.x 1.24.x 1.25.x 1.26.x ^{(≥ 1.9.2)}	1.24.x 1.25.x 1.26.x
OpenShift⁽⁷⁾	4.6 4.7 4.8	4.7 4.8	4,8 4,9 4,10	4.10 4.11	4.11 4.12
Rancher Kubernetes Engine (RKE)⁽⁷⁾	N/A	N/A	N/A	1.3.8	v1.26.2+rke2r1
Componentes	1.6 ⁽³⁾	1.7 ⁽³⁾	1,8	1.9	1.10
Anthos Service Mesh (ASM)	1.9.x 1.10.x 1.12.x 1.13.x	1.10.x 1.11.x 1.12.x 1.13.x ^{(≥ 1.7.2)} 1.14.x 1.15.x ^{(≥ 1.7.6)}	1.11.x 1.12.x 1.13.x 1.14.x 1.15.x	1.17.x⁽¹¹⁾	1.17.x⁽¹¹⁾
JDK	JDK 11	JDK 11	JDK 11	JDK 11	JDK 11
cert-manager	1.5.4	1.7.x	1.7.x 1.8.x 1.9.x 1.10.x 1.11.x	1.10.x 1.11.x	1.10.x 1.11.x 1.12.x
Cassandra	3.11.10	3.11.10	3.11.10	3.11.10	3.11.10
⁽¹⁾ Nas versões 1.8, 1.9 e 1.10 do Anthos, siga as instruções nestes documentos para evitar conflitos com `cert-manager`: Anthos 1.8.2 ou superior: Conflito com `cert-manager` ao atualizar para a versão 1.8.2 ou superior. Anthos 1.9: Conflito com `cert-manager` ao atualizar para a versão 1.9.0 ou 1.9.1. Anthos 1.10 ou superior: Instalação `cert-manager`em conflito. ⁽²⁾ Apoio técnico disponível com a versão 1.7.2 e mais recentes do Apigee Hybrid. ⁽³⁾ As datas oficiais de FdV para as versões 1.8 e anteriores do Apigee hybrid foram alcançadas. Os patches mensais normais já não estão disponíveis. Estas versões já não são oficialmente suportadas, exceto para clientes com exceções explícitas e oficiais para apoio técnico contínuo. Os outros clientes têm de fazer a atualização. ⁽⁴⁾As versões 1.12 e anteriores do Anthos em bare metal e VMWare estão fora do suporte. Consulte a Política de Apoio Técnico de Versões do Anthos em Bare Metal e as versões dos clusters do Anthos no VMware. ⁽⁵⁾Anthos em bare metal e VMWare requer o ASM 1.14 ou posterior. Recomendamos que atualize para o hybrid v1.8 e mude para o gateway de entrada do Apigee, que já não requer a instalação do ASM no cluster híbrido. ⁽⁶⁾ Apoio técnico disponível com o Apigee Hybrid versão 1.8.4 e mais recente. ⁽⁷⁾ Os clusters anexados não são necessários para o Apigee Hybrid v1.8 e mais recentes que usam o Apigee ingressgateway.. ⁽⁸⁾ Não suportado com o Apigee Hybrid versão 1.8.4 e mais recente. ⁽⁹⁾ Apoio técnico disponível com a versão 1.7.6 e mais recentes do Apigee Hybrid. ⁽¹⁰⁾ Não suportado com a versão 1.8.5 e mais recentes do Apigee Hybrid. ⁽¹¹⁾ O ASM é instalado automaticamente com o Apigee Hybrid 1.9 e mais recente. ⁽¹²⁾ Apoio técnico disponível com a versão 1.9.2 e mais recente do Apigee Hybrid. ⁽¹³⁾ Os números das versões dos clusters do Anthos no AWS (multinuvem) refletem agora as versões do Kubernetes. Consulte o artigo Versão do Anthos e suporte de atualizações para ver detalhes da versão e patches recomendados.

Acerca dos clusters associados

Para o Apigee hybrid versões 1.7.x e anteriores, tem de usar clusters anexados do Anthos se quiser executar o Apigee hybrid num contexto de várias nuvens no Elastic Kubernetes Service (EKS), no Azure Kubernetes Service (AKS) ou noutro fornecedor de serviços Kubernetes de terceiros suportado. A associação de clusters permite à Google medir a utilização do Anthos Service Mesh (ASM). O registo do cluster de terceiros é opcional. Registe-se apenas se quiser ver o cluster em anexo no Google Cloud console. Para mais informações, consulte o artigo Anexe clusters Kubernetes de terceiros ao Google Cloud.

Para a versão 1.8.x do Apigee hybrid, são necessários clusters anexados do Anthos se estiver a usar o Anthos Service Mesh para o gateway de entrada. Se estiver a usar o gateway de entrada do Apigee, os clusters anexados do Anthos são opcionais.

Reverter uma atualização

Siga estes passos para reverter uma atualização anterior:

Limpe as tarefas concluídas para o espaço de nomes de tempo de execução híbrido, em que NAMESPACE é o espaço de nomes especificado no ficheiro de substituições, se tiver especificado um espaço de nomes. Caso contrário, o espaço de nomes predefinido é apigee:
```
kubectl delete job -n NAMESPACE \
  $(kubectl get job -n NAMESPACE \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
```

Limpe as tarefas concluídas para o espaço de nomes apigee-system:

kubectl delete job -n apigee-system \
  $(kubectl get job -n apigee-system \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')

Altere a variável APIGEECTL_HOME para apontar para o diretório que contém a versão anterior de apigeectl. Por exemplo:
```
export APIGEECTL_HOME=PATH_TO_PREVIOUS_APIGEECTL_DIRECTORY
```
No diretório raiz da instalação para a qual quer reverter, execute o comando apigeectl apply, verifique o estado dos seus pods e, em seguida, execute o comando apigeectl init. Certifique-se de que usa o ficheiro de substituições original para a versão para a qual quer reverter:
1. No diretório hybrid-files, execute apigeectl apply:
```
$APIGEECTL_HOME/apigeectl apply -f ORIGINAL_OVERRIDES_FILE
```
  Em que ORIGINAL_OVERRIDES_FILE é o caminho relativo e o nome do ficheiro das substituições para a instalação híbrida da versão anterior, por exemplo, ./overrides/overrides1.8.yaml.
2. Verifique o estado dos seus pods:
```
kubectl -n NAMESPACE get pods
```
  Onde NAMESPACE é o espaço de nomes híbrido do Apigee.
3. Verifique o estado de apigeeds:
```
kubectl describe apigeeds -n apigee
```
  O resultado deve ter um aspeto semelhante ao seguinte:
```
Status:
  Cassandra Data Replication:
  Cassandra Pod Ips:
    10.8.2.204
  Cassandra Ready Replicas:  1
  Components:
    Cassandra:
      Last Successfully Released Version:
        Revision:  v1-f8aa9a82b9f69613
        Version:   v1
      Replicas:
        Available:  1
        Ready:      1
        Total:      1
        Updated:    1
      State:        running
  Scaling:
    In Progress:         false
    Operation:
    Requested Replicas:  0
  State:                 running
```
  Avance para o passo seguinte apenas quando o apigeeds pod estiver em execução.
4. Execute o seguinte comando para tomar nota dos novos valores de contagem de réplicas do processador de mensagens após a atualização. Se estes valores não corresponderem aos que definiu anteriormente, altere os valores no ficheiro de substituições para corresponderem à sua configuração anterior.
```
apigeectl apply -f ORIGINAL_OVERRIDES_FILE --dry-run=client --print-yaml --env ENV_NAME 2>/dev/null |grep "runtime:" -A 25 -B 1| grep "autoScaler" -A 2
```
  O resultado deve ter um aspeto semelhante ao seguinte:
```
      autoScaler:
        minReplicas: 2
        maxReplicas: 10
```
5. Corrida apigeectl init:
```
$APIGEECTL_HOME/apigeectl init -f ORIGINAL_OVERRIDES_FILE
```

Atualizar o Apigee Hybrid para a versão 1.9 Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Vista geral da atualização para a versão 1.9.4

Pré-requisitos

Prepare-se para atualizar para a versão 1.9

Faça uma cópia de segurança da sua instalação híbrida (recomendado)

Linux

Mac OS

Windows

Adicione a função Agente do Cloud Trace à conta de serviço do tempo de execução do Apigee. (Opcional)

Produção

Não produção

Produção

Não produção

Exemplo

Instale o gateway de entrada do Apigee se a sua instalação usar o Anthos Service Mesh

Sintaxe

Exemplo

Instale o runtime híbrido 1.9.4

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Linux

Mac OS

Windows

Produção

Não prod

Instale a app 1.9.4-hotfix.1

Atualize a versão do Kubernetes

Clique para expandir uma lista de plataformas suportadas

Plataformas

Componentes

Acerca dos clusters associados

Reverter uma atualização

Atualizar o Apigee Hybrid para a versão 1.9

Instale a app `1.9.4-hotfix.1`