Installa il componente del parco risorse Knative serving

Installa Knative serving come componente del parco risorse GKE Enterprise.

Prima di iniziare

Panoramica

L'installazione di Knative serving come componente del parco risorse include:

  1. Attivare i parchi nel progetto Google Cloud.
  2. Copia del gateway gke-system-gateway nel Gateway knative-ingress-gateway.
  3. Installazione della risorsa personalizzata Knative serving nel cluster.

Tieni presente che durante questa procedura, i servizi Knative serving esistenti continueranno per gestire il traffico senza interruzioni.

Installa il componente del parco risorse Knative serving

In questa sezione, lo script di migrazione viene utilizzato per installare Knative serving come componente del parco risorse.

  1. Esegui il seguente comando per avviare lo script di migrazione:

    ./migration-addon.sh --command install-cloud-run-v2
    

    Tieni presente che se riscontri problemi con questo passaggio o vuoi apportare modifiche, puoi eseguire di nuovo questo comando dello script di migrazione.

  2. Nel terminale, lo script di migrazione ti chiede di confermare l'esecuzione di ogni azione. Per continuare, inserisci y a ogni richiesta.

    I prompt durante la procedura di installazione del componente del fleet di pubblicazione di Knative sono simili al seguente:

    In the process of installing the Knative serving fleet component, the
    script performs the following:
    1. Enabling the fleet in your Google Cloud project.
    2. Copy gke-system-gateway Gateway to knative-ingress-gateway Gateway
    3. Installing the Knative serving custom resource in your cluster.
    Continue? [Y/n] y
    
    1. Enabling Anthos services?
    Continue? [Y/n] y
    
    Operation "operations/acf.p2-625914735451-10d4b6ff-68e1-4a09-97c4-79b209be5031" finished successfully.
    
    2. Copying gke-system-gateway Gateway to knative-ingress-gateway Gateway
    
    configmap/original-knative-ingress-gateway-spec unchanged
    gateway.networking.istio.io/knative-ingress-gateway patched (no
    change)
    configmap/config-istio patched
    configmap/config-istio patched
    gateway.networking.istio.io "gke-system-gateway" deleted
    
    3. Install the Knative serving custom resource in your cluster?
    Continue? [Y/n] y
    
    Waiting for Knative serving feature to be enabled
    Knative serving feature is enabled.
    The YAML file for the new operator appdevexperience-operator was created at
    /tmp/tmp.bI7H1qagGa/cloudrun.yaml
    customresourcedefinition.apiextensions.k8s.io/cloudruns.operator.run.cloud.google.com
    condition met
    kubeconfig entry generated for my-gke-cluster.
    Added the custom resource for Knative serving
    
    Waiting for Knative serving serving to be ready...
    Knative serving serving is not ready yet.
    Knative serving serving is ready.
    
    Removing the ValidatingWebhookConfiguration used to prevent deletion
    validatingwebhookconfiguration.admissionregistration.k8s.io
    "prevent-deletion-cloud-run-resources" deleted
    
    Knative serving has been installed as an Anthos fleet component
    

    Problema noto per i cluster privati

    Se l'installazione di Knative serving si trova su un cluster privato su Google Cloud, potresti ricevere un errore di timeout da:

    Waiting for CRD cloudruns.operator.run.cloud.google.com to be created
    

    Per aggirare l'errore di timeout, esegui questo comando:

    cat <<EOF | kubectl apply -f -
    apiVersion: operator.run.cloud.google.com/v1alpha1
    kind: CloudRun
    metadata:
      name: cloud-run
    EOF
    
  3. Verifica che il componente della funzionalità Knative serving sia attivato:

    Console

    Controlla se il componente Knative serving è impostato su Abilitato nella Console Google Cloud:

    Vai a Gestione funzionalità

    Riga di comando

    Visualizza se lo stato appdevexperience è ACTIVE:

    gcloud alpha container hub features list  --project=PROJECT_ID
    

    Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud.

    Per dettagli e opzioni aggiuntive, consulta il riferimento all'elenco delle funzionalità di gcloud alpha container hub.

Passaggi successivi

Ora che Cloud Service Mesh e Knative serving sono installati, puoi iniziare a eseguire la migrazione e il deployment del traffico nelle nuove risorse.

Esegui il rollback

Se devi eseguire il rollback delle modifiche apportate nei passaggi precedenti, puoi utilizzare lo script di migrazione per:

  • Rimuovi il controllo delle risorse Knative serving dall'operatore. appdevexperience-operator.
  • Elimina la risorsa personalizzata Knative serving e disinstalla l'operatore appdevexperience-operator.
  • (Facoltativo) Disattiva Knative serving nel parco risorse del tuo progetto Google Cloud.

Per avviare la procedura di rollback:

  1. Esegui il seguente comando per avviare lo script di migrazione:

    ./migration-addon.sh --command rollback-install-cloud-run-v2
    
  2. Nel terminale, lo script di migrazione ti chiede di confermare l'esecuzione di ogni azione. Inserisci y a ogni richiesta per continuare.

    I prompt durante il processo di disinstallazione del parco risorse simile al seguente:

    In the step of rolling back the Knative serving fleet installation, the
    script performs the following:
    1. Remove control of Knative serving resources from the operator
       `appdevexperience-operator`.
    2. Delete the Knative serving custom resource and uninstall the operator
       `appdevexperience-operator`.
    3. Revert the changes installed by the Knative serving fleet component.
    4. Optional: Disable Knative serving in the GKE Enterprise fleet of your
       Google Cloud project.
    Continue? [Y/n] y
    
    1. Removing control of Knative serving resources from the operator
       `appdevexperience-operator`.
    
    Creating a ValidatingWebhookConfiguration to prevent the deletion of the
    resources under the following namespaces:
    knative-serving, cloud-run-system, and gke-system
    
    waiting for OwnerReferences of Knative serving resources to be deleted
    
    OwnerReferences of Knative serving resources are deleted
    
    Waiting for Knative serving serving to be ready...
    Knative serving serving is ready.
    
    2. Delete the Knative serving custom resource and uninstall the operator
       `appdevexperience-operator`?
    Continue? [Y/n] y
    
    cloudrun.operator.run.cloud.google.com "cloud-run" deleted
    clusteractiveoperand.operand.run.cloud.google.com/sha256-3c1c80a329 patched
    
    waiting for appdevexperience namespace to be deleted
    
    3. Revert the changes installed by the fleet component?
    configmap/config-observability patched
    
    4. Optional: Disable Knative serving in the Anthos fleet of your
       Google Cloud project?
       You can choose to skip this step and keep the feature enable within your
       Anthos fleet. For example, you might want to keep the
       Knative serving fleet component enabled because it was enabled prior to
       this migration.
    Continue (or Skip)? [Y/n] n