Questa documentazione riguarda la versione più recente di Knative serving, che utilizza i parchi risorse e Anthos Service Mesh. Scopri di più.

La versione precedente (Cloud Run for Anthos) è stata archiviata, ma la documentazione rimane disponibile per gli utenti esistenti.

Versioni disponibili

Più recente
Archivia

Questa pagina è stata tradotta dall'API Cloud Translation.

Migrazione dei carichi di lavoro a Knative OSS

Utilizza questa guida per eseguire la migrazione dei tuoi carichi di lavoro in modo che vengano eseguiti offerta Knative open source con Google Kubernetes Engine. In generale, la migrazione dei carichi di lavoro richiede l'installazione Knative Serving in un nuovo cluster GKE ed eseguire nuovamente il deployment di ciascuno dei tuoi servizi cluster Knative.

Sebbene l'utilizzo, la gestione e il supporto di Knative open source siano una tua scelta e una tua responsabilità, la migrazione a Knative ti offre l'opportunità di continuare a eseguire i tuoi carichi di lavoro sulla piattaforma Google Kubernetes Engine.

Differenze notevoli:

Il supporto è limitato a Google Kubernetes Engine. Puoi contattare la community Knative per ricevere assistenza su Knative.
Google Cloud CLI (gcloud) è supportato solo da Google Kubernetes Engine. Knative supporta i comandi kubectl e kn. Scopri come installare kn

Prima di iniziare

Devi avere accesso a un nuovo cluster GKE.
- Puoi creare il nuovo cluster nello stesso progetto Google Cloud o in un nuovo progetto.
- Il cluster deve soddisfare Requisiti di Knative.
- Scopri come creare un cluster:
  - Cluster standard
  - Cluster privato
Devi eseguire manualmente il porting di eventuali configurazioni del cluster nel nuovo cluster Knative, tra cui, a titolo esemplificativo:
Devi creare e configurare nuovi controlli di accesso IAM e RBAC:
- Configurare il controllo dell'accesso
- Workload Identity

Installazione di Knative su Google Kubernetes Engine

Knative offre diverse opzioni di installazione e livelli di networking che puoi scegliere di utilizzare. I seguenti passaggi di installazione di Knative utilizzano il metodo dell'operatore Knative e il livello di rete Istio.

Installa Knative Operator:

Esegui il deployment dell'operatore nel cluster:

kubectl apply -f https://github.com/knative/operator/releases/download/knative-vVERSION/operator.yaml

Sostituisci VERSION con una versione dell'operatore Knative.

Esempio:

kubectl apply -f https://github.com/knative/operator/releases/download/knative-v1.3.1/operator.yaml

Imposta l'interfaccia a riga di comando kubectl in modo che utilizzi lo spazio dei nomi default:
```
kubectl config set-context --current --namespace=default
```

Verifica che l'operatore sia stato creato correttamente:

kubectl get deployment knative-operator

Risultato:

NAME               READY   UP-TO-DATE   AVAILABLE   AGE
knative-operator   1/1     1            1           6m43s

Installa il componente Knative Serving:

Crea un file YAML con quanto segue, ad esempio SERVING_FILENAME.yaml:

apiVersion: v1
kind: Namespace
metadata:
  name: knative-serving
---
apiVersion: operator.knative.dev/v1alpha1
kind: KnativeServing
metadata:
  name: knative-serving
  namespace: knative-serving

Esegui il deployment del file YAML nel tuo cluster:
```
kubectl apply -f SERVING_FILENAME.yaml
```
Sostituisci SERVING_FILENAME con il file YAML che è stato creato.

Installa Istio con inserimento di file collaterali come livello di networking:

Hai la possibilità di eseguire e configurare un'installazione alternativa di Istio. Vedi tutti Installazione di Istio opzioni sul sito web di Knative. Tieni presente che questa installazione può richiedere più di 30 minuti.
1. Scarica Istio dalla pagina della release.
2. Installa Istio eseguendo questo comando con --set hub=gcr.io/istio-release flag da evitare Limitazione di frequenza Docker:
```
istioctl install --set hub=gcr.io/istio-release
```
3. Esegui questo comando per abilitare l'inserimento di file collaterali:
```
kubectl label namespace default istio-injection=enabled
```
4. (Facoltativo) Per impostazione predefinita, Istio è installato nello spazio dei nomi istio-system. Se vuoi configurare uno spazio dei nomi diverso, puoi seguire i seguenti passaggi:
  1. Per configurare uno spazio dei nomi personalizzato per Istion, aggiungi il token spec.config.istio attributi a SERVING_FILENAME.yaml. Ad esempio:
```
apiVersion: operator.knative.dev/v1alpha1
kind: KnativeServing
metadata:
  name: knative-serving
  namespace: knative-serving
spec:
  # ...
  config:
    istio:
      local-gateway.LOCAL_GATEWAY_NAMESPACE.knative-local-gateway: "knative-local-gateway.ISTIO_NAMESPACE.svc.cluster.local"
```
    Sostituisci:
    - LOCAL_GATEWAY_NAMESPACE è il nome del namespace in cui hai installato Knative Serving. Valore predefinito: knative-serving
    - ISTIO_NAMESPACE è lo spazio dei nomi in cui Istio è installato. Predefinita: istio-system
  2. Esegui il deployment del servizio SERVING_FILENAME.yaml aggiornato nel tuo cluster Knative:
```
kubectl apply -f SERVING_FILENAME.yaml
```
  3. Verifica l'installazione di Istio confermando che istio-ingressgateway si trova nello spazio dei nomi specificato:
```
kubectl get svc istio-ingressgateway -n ISTIO_NAMESPACE
```
    Sostituisci ISTIO_NAMESPACE con il nome dello spazio dei nomi in cui hai installato Istio. Predefinita: istio-system
    
    Risultato:
```
NAME                   TYPE           CLUSTER-IP      EXTERNAL-IP    PORT(S)                                      AGE
istio-ingressgateway   LoadBalancer   10.232.10.190   34.123.5.116   15021:30337/TCP,80:32549/TCP,443:31210/TCP   119m
```

Migrazione di un servizio

Per eseguire la migrazione di un servizio, devi eseguire il deployment del codice YAML di configurazione del deployment nel tuo cluster Knative.

Esporta il tuo servizio Knative serving in un file YAML locale eseguendo il seguente comando:
```
gcloud run services describe SERVICE --format export --namespace NAMESPACE --cluster CLUSTER --platform gke > FILENAME.yaml
```
Sostituisci:
- SERVICE con il nome del tuo servizio Knative serving.
- NAMESPACE con lo spazio dei nomi in cui sia in esecuzione.
- CLUSTER con il nome del cluster in cui se il servizio è in esecuzione.
- FILENAME con un nome file univoco del tuo scelta.
Modifica il file FILENAME.yaml esportato da rimuovere configurazioni Knative serving indesiderate eliminando uno dei seguenti attributi e i relativi valori:
- metadata.annotations.kubectl.kubernetes.io/last-applied-configuration
- metadata.managedFields
- spec.template.spec.containers.readinessProbes
- spec.template.spec.enableServiceLinks
  
  Ad esempio, potrebbe essere necessario rimuovere la seguente configurazione dagli attributi spec: > template: > spec: > containers::
```
...
 readinessProbe:
   successThreshold: 1
   tcpSocket: {}
...
```
Esegui il deployment del file .yaml modificato nel tuo cluster Knative:
```
kubectl apply -f SERVICE.yaml
```
Sostituisci SERVICE con il nome del file di configurazione del servizio.
Accedi al servizio di cui hai eseguito il deployment utilizzando un dominio di test o i comandi cURL. Puoi utilizzare un servizio DNS jolly per testare l'accesso esterno al tuo servizio. Per altre opzioni, consulta la sezione sulla configurazione del DNS nella documentazione di Knative.

Per utilizzare Magic DNS (sslip.io), esegui questo comando.

Tieni presente che puoi anche usare direttamente sslip.io.
```
kubectl apply -f https://github.com/knative/serving/releases/download/knative-vVERSION/serving-default-domain.yaml
```
Sostituisci VERSION con la tua versione di Knative Serving.

Esempio:
```
kubectl apply -f https://github.com/knative/serving/releases/download/knative-v1.3.0/serving-default-domain.yaml
```

Eseguire la migrazione del traffico al tuo servizio

Dopo aver testato i servizi appena implementati e aver completato la migrazione di tutto il traffico di produzione, puoi configurare il tuo dominio personalizzato e aggiornare i record DNS con il tuo registrar. Segui le istruzioni alla pagina Configurazione di domini personalizzati.