Distribuire un gateway self-hosted in Kubernetes con YAML

Questo articolo descrive i passaggi per la distribuzione del componente gateway self-hosted di Azure Gestione API in un cluster Kubernetes.

Importante

Il supporto per Azure Gestione API le immagini del contenitore self-hosted versione 0 e 1 del contenitore terminano il 1° ottobre 2023, insieme all'API di configurazione corrispondente v1. Usare la guida alla migrazione per usare il gateway self-hosted v2.0.0 o versione successiva con l'API di configurazione v2. Per altre informazioni, vedere la documentazione relativa alla deprecazione

Nota

È anche possibile distribuire un gateway self-hosted in un cluster Kubernetes abilitato per Azure Arc come estensione del cluster.

Disponibilità

Importante

Questa funzionalità è disponibile nei livelli Premium e Developer di Gestione API.

Prerequisiti

Eseguire la distribuzione in Kubernetes

  1. Selezionare Gateway inDistribuzione e infrastruttura.

  2. Selezionare la risorsa gateway self-hosted da distribuire.

  3. Selezionare Distribuzione.

  4. Un token di accesso nella casella di testo Token è stato generato automaticamente in base ai valori predefiniti Di scadenza e Chiave privata . Se necessario, scegliere i valori in uno o entrambi i controlli per generare un nuovo token.

  5. Selezionare la scheda Kubernetes in Script di distribuzione.

  6. Selezionare il <collegamento al file gateway-name.yml> e scaricare il file YAML.

  7. Selezionare l'icona di copia nell'angolo inferiore destro della casella di testo Distribuisci per salvare i kubectl comandi negli Appunti.

  8. Quando si usa servizio Azure Kubernetes (servizio Azure Kubernetes), eseguire az aks get-credentials --resource-group <resource-group-name> --name <resource-name> --admin in una nuova sessione del terminale.

  9. Eseguire i comandi per creare gli oggetti Kubernetes necessari nello spazio dei nomi predefinito e avviare i pod gateway self-hosted dall'immagine del contenitore scaricata dal Registro artefatti Microsoft.

    • Il primo passaggio crea un segreto Kubernetes che contiene il token di accesso generato nel passaggio 4. Crea quindi una distribuzione Kubernetes per il gateway self-hosted che usa un oggetto ConfigMap con la configurazione del gateway.
  10. Eseguire il comando seguente per verificare se la distribuzione è riuscita. Si noti che l'inizializzazione di tutti gli oggetti potrebbe richiedere un po' di tempo e per inizializzare i pod.

    kubectl get deployments
    

    Dovrebbe restituire

        NAME             READY   UP-TO-DATE   AVAILABLE   AGE
    <gateway-name>   1/1     1            1           18s
    
  11. Eseguire il comando seguente per verificare se il servizio è stato creato correttamente. Si noti che gli indirizzi IP e le porte del servizio saranno diversi.

    kubectl get services
    

    Dovrebbe restituire

    NAME             TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
    <gateway-name>   LoadBalancer   10.99.236.168   <pending>     80:31620/TCP,443:30456/TCP   9m1s
    
  12. Indietro al portale di Azure e selezionare Panoramica.

  13. Verificare che Status mostri un segno di spunta verde, seguito da un numero di nodi che corrisponde al numero di repliche specificate nel file YAML. Questo stato indica che i pod gateway self-hosted distribuiti comunicano correttamente con il servizio Gestione API e hanno un normale "heartbeat".

    Stato del gateway

Suggerimento

Eseguire il kubectl logs deployment/<gateway-name> comando per visualizzare i log da un pod selezionato in modo casuale, se ne sono presenti più. Eseguire kubectl logs -h per un set completo di opzioni di comando, ad esempio come visualizzare i log per un pod o un contenitore specifico.

Passaggi successivi