Instalar o Knative Serving no VMware

Saiba como instalar o Knative Serving nos seus clusters do GKE fora Google Cloud. O Knative Serving usa agora o Cloud Service Mesh e os conjuntos do GKE Enterprise. Saiba o que é novo e o que mudou no Knative serving fleet installations.

Aviso: a execução dos passos nesta página vai fazer uma nova instalação do Knative serving no VMware e substituir irreversivelmente a instalação anterior não pertencente à frota. Não avance com os passos seguintes nos seus clusters para os quais ativou anteriormente o Knative serving.

Para instalações "de avaliação gratuita" anteriores do Knative Serving, tem de primeiro atualizar o Knative Serving no VMware para usar frotas do GKE Enterprise.

Use os passos nesta página para configurar uma nova instalação ou para atualizar uma instalação de frota do Knative serving.

Antes de começar

Tem de se certificar de que cumpre os pré-requisitos de instalação.

Configure o seu CloudRun recurso personalizado

Tem de criar e configurar manualmente o recurso personalizado CloudRun para configurar a instalação.

Para criar manualmente um recurso personalizado CloudRunpara clusters do GKE externos Google Cloud:

  1. Tem de criar ou ter uma conta de serviço existente à qual tenha sido concedida a função de escritor de métricas de monitorização (monitoring.metricWriter) necessária.

    • Para criar uma nova conta de serviço e, em seguida, transferir a chave, consulte o artigo Usar contas de serviço.

    • Se tiver uma conta de serviço existente com as autorizações necessárias, localize a chave que transferiu quando criou essa conta de serviço.

  2. Certifique-se de que o Cloud Monitoring está ativado no Google Distributed Cloud.

  3. Crie o espaço de nomes knative-serving:

    kubectl create namespace knative-serving

  4. Crie um segredo no espaço de nomes knative-serving que contenha a conta de serviço com autorizações monitoring.metricWriter:

    kubectl create secret -n knative-serving generic SECRET_NAME --from-file=PATH_TO_KEY_FILE/SECRET_KEY

    Substituição:

    • SECRET_NAME com o nome que escolher para o segredo.
    • SECRET_KEY com o nome do ficheiro que inclui as suas credenciais. Exemplo: key.json
    • PATH_TO_KEY_FILE com o caminho para o diretório do SECRET_KEY.

    Consulte a referência kubectl create secret para saber mais, incluindo flags opcionais.

  5. Crie um ficheiro YAML com os seguintes atributos, por exemplo cloudrunanthos.yaml:

    apiVersion: operator.run.cloud.google.com/v1alpha1
kind: CloudRun
metadata:
  name: cloud-run
spec:
  metricscollector:
    stackdriver:
      projectid: PROJECT_ID
      gcpzone: CLUSTER_LOCATION
      clustername: CLUSTER_NAME
      secretname: SECRET_NAME
      secretkey: SECRET_KEY

    Substitua o seguinte:

    • PROJECT_ID com o ID do seu Google Cloud projeto.
    • CLUSTER_LOCATION com a região ou a zona em que o seu cluster está localizado.
    • CLUSTER_NAME com o ID do cluster ou o identificador totalmente qualificado do cluster.
    • SECRET_NAME com o nome do segredo para a conta de serviço do espaço de nomes knative-serving.

    • SECRET_KEY com a chave do segredo para a conta de serviço do espaço de nomes knative-serving. Por exemplo: key.json

      Para ver detalhes sobre as contas de serviço, consulte:

    Exemplo

    Neste exemplo de CloudRun recurso personalizado, os detalhes de configuração do Cloud Monitoring são especificados para usar o segredo my-gcp-logging-secret e a chave key.json:

     apiVersion: operator.run.cloud.google.com/v1alpha1
 kind: CloudRun
 metadata:
   name: cloud-run
 spec:
   metricscollector:
     stackdriver:
       projectid: my-gcp-project-id
       gcpzone: us-central1-c
       clustername: my-anthos-cluster-name
       secretname: my-gcp-logging-secret
       secretkey: key.json
 ```

Ative e instale o Knative Serving

Ative o componente Knative serving na sua frota do GKE Enterprise e, em seguida, implemente o seu recurso personalizado CloudRun:

  1. Ative a publicação do Knative na sua frota:

    gcloud container fleet cloudrun enable --project=PROJECT_ID

    Substitua PROJECT_ID pelo ID do seu Google Cloud projeto.

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

  2. Opcional: verifique se o componente da funcionalidade Knative serving está ativado:

    Consola

    Veja se o componente Knative Serving está ativado na Google Cloud consola:

    Aceda ao Gestor de funcionalidades

    Linha de comandos

    Veja se o estado appdevexperience é ACTIVE:

    gcloud container fleet features list  --project=PROJECT_ID

    Substitua PROJECT_ID pelo ID do seu Google Cloud projeto.

    Para ver detalhes e opções adicionais, consulte a lista de funcionalidades do gcloud container fleet de referência.

    Resultado:

    NAME               STATE
appdevexperience   ACTIVE

  3. Para cada cluster do GKE Enterprise onde quer instalar o Knative Serving, tem de implementar o seu CloudRun recurso personalizado:

    gcloud

    gcloud container fleet cloudrun apply --kubeconfig=KUBECONFIG --context=CONTEXT --config=CONFIG_FILE

    Substitua o seguinte:

    • KUBECONFIG com o caminho absoluto para o ficheiro de configuração do kubectl.
    • CONTEXT com o nome do contexto no ficheiro de configuração do kubectl a usar para estabelecer ligação.
    • CONFIG_FILE com o caminho relativo do nome do ficheiro para o seu recurso personalizado.cloudRun Exemplo cloudrunanthos.yaml.

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

    kubectl

    kubectl apply --kubeconfig=KUBECONFIG --filename CONFIG_FILE

    Substitua o seguinte:

    • KUBECONFIG com o caminho absoluto para o ficheiro de configuração do kubectl.
    • CONFIG_FILE com o nome do ficheiro e o caminho relativo para o seu recurso personalizado cloudRun. Exemplo cloudrunanthos.yaml.

    Para ver detalhes e opções adicionais, consulte a referência do comando kubectl apply.

  4. Verifique se a publicação do Knative foi ativada no cluster:
    1. Abra a Google Cloud consola:

      Aceda aos clusters do GKE

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

    3. Execute este comando para verificar se consegue ver os detalhes da versão do Knative Serving: kubectl get all -n knative-serving -o 'go-template={{index .metadata.labels "serving.knative.dev/release"}}'
    4. Verifique se todas as implementações específicas do Knative Serving estão em estado de execução nos espaços de nomes knative-serving e appdevexperience.

O que se segue?

Configure a instalação do Knative Serving.