Como instalar o Knative serving no Google Cloud

Saiba como instalar o Knative serving nos clusters do GKE no Google Cloud. O Knative serving agora usa frotas do Cloud Service Mesh e do GKE Enterprise. Saiba o que há de novo e o que mudou nas instalações de frota do Knative serving.

Aviso: as etapas desta página realizam uma nova instalação do Knative serving e substituem de forma irreversível a instalação anterior que não seja da frota. Não prossiga com as etapas a seguir nos clusters para os quais você ativou anteriormente o Knative serving.

Para instalações anteriores de "teste gratuito" do Knative serving, será preciso primeiro fazer upgrade do Knative serving para usar frotas do GKE Enterprise.

Use esta página para instalar os componentes padrão do Knative serving nos seus clusters do GKE no Google Cloud com a seguinte configuração:

  • O Knative serving no Google Cloud é configurado para clusters públicos por padrão.

  • As métricas do Cloud Monitoring para o GKE Enterprise nos clusters do Google Cloud são ativadas pelo padrão.

Antes de começar

  • Para instalar o Knative serving em clusters particulares no Google Cloud, você precisa realizar uma instalação personalizada.

  • Verifique se você atende aos pré-requisitos de instalação.

  • Se o Knative serving estiver instalado no seu cluster, verifique se o "complemento do GKE" não existe antes da execução dessas etapas de instalação dos componentes da frota. Se o "complemento" estiver instalado, siga as etapas para fazer upgrade para as frotas do GKE Enterprise.

    Verifique se o complemento GKE está instalado.

    Para verificar se a instalação do Knative serving é o "complemento do GKE", execute o seguinte comando: 

    gcloud container clusters describe \
CLUSTER_NAME \
--region CLUSTER_LOCATION \
--project PROJECT_ID --format='get(addonsConfig.cloudRunConfig)'

    Substitua:

    • CLUSTER_NAME pelo nome do cluster.
    • CLUSTER_LOCATION: pelo local em que o cluster está localizado.
    • PROJECT_ID pelo ID do seu projeto do Google Cloud.

    Resultados:

    • "Complemento do GKE" não instalado:
      • Nada será retornado ao terminal se o complemento nunca tiver sido instalado.
      • disabled=true será retornado se o complemento tiver sido desinstalado anteriormente.
    • "Complemento do GKE" está instalado: se o complemento estiver instalado no cluster, os detalhes da configuração do complemento serão retornados. Exemplo: loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL
    Exemplo:
    O exemplo a seguir demonstra que o Knative serving foi instalado no cluster my-addon-cluster pelo "complemento do GKE", que está configurado para lidar com tráfego externo: 
    gcloud container clusters describe my-addon-cluster \
--region us-central1-c --project my-gcp-project \
--format='get(addonsConfig.cloudRunConfig)'

    Resposta: 

    loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL

Como instalar o Knative serving

Para instalar os componentes padrão do Knative Serving:

  1. Ative o Knative serving na sua frota:

    gcloud container fleet cloudrun enable --project=PROJECT_ID

    Substitua PROJECT_ID pelo ID do projeto do Google Cloud.

    Para mais detalhes e opções, consulte a referência gcloud container fleet cloudrun enable.

  2. Opcional: verifique se o componente do recurso Knative serving está ativado:

    Console

    Confira se o componente do Knative serving está ativado no Console do Google Cloud:

    Acessar o gerenciador de recursos

    Linha de comando

    Veja se o estado appdevexperience é ACTIVE:

    gcloud container fleet features list  --project=PROJECT_ID

    Substitua PROJECT_ID pelo ID do projeto do Google Cloud.

    Para mais detalhes e opções, consulte a referência da lista de recursos da frota de contêiner do gcloud.

    Resultado:

    NAME               STATE
appdevexperience   ACTIVE

  3. Para cada cluster do GKE Enterprise em que você quer instalar o Knative serving, execute o comando correspondente: 

    gcloud container fleet cloudrun apply --gke-cluster=CLUSTER_LOCATION/CLUSTER_NAME

    Substitua:

    • CLUSTER_LOCATION pela região ou zona em que o cluster está localizado.
    • CLUSTER_NAME pelo ID do cluster ou pelo identificador totalmente qualificado do cluster.

    Para detalhes e opções adicionais, consulte a referência gcloud container fleet cloudrun apply.

  4. Verifique se o Knative serving está ativado no cluster:
    1. Abra o Console do Google Cloud:

      Acesse os clusters do GKE

    2. Clique no nome do cluster para abrir o painel de detalhes.

    3. Execute este comando para verificar se é possível ver os detalhes da versão do Knative serving: kubectl get namespace knative-serving -o 'go-template={{index .metadata.labels "serving.knative.dev/release"}}'
    4. Verifique se todas as implantações específicas do Knative serving estão com status de execução nos namespaces knative-serving e appdevexperience.

A seguir

Configure sua instalação do Knative serving.