Eseguire app App Engine su GKE

Questa guida mostra come eseguire un'app dell'ambiente flessibile App Engine su GKE. Per eseguire l'app su GKE, devi creare un Dockerfile, creare un container con Cloud Build ed eseguirlo in GKE. Non è necessario apportare modifiche al codice.

Prima di iniziare

Prima di seguire le istruzioni riportate in questa pagina, procedi nel seguente modo:

  1. Verifica che il deployment e l'esecuzione dell'app nell'ambiente flessibile di App Engine avvengano correttamente.

  2. In queste istruzioni, utilizzerai lo stesso progetto che hai utilizzato per l'app App Engine. Se vuoi, puoi sempre creare e utilizzare un nuovo progetto.

  3. Enable the GKE, Cloud Build APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

  4. Scarica e installa Google Cloud CLI, quindi inizializza lo strumento gcloud: Scarica Google Cloud SDK.

    In alternativa, puoi utilizzare Cloud Shell, che include gcloud CLI, git e altre funzionalità preinstallate, come supporto linguistico, strumenti ed editor.

  5. Installa lo strumento a riga di comando kubectl:

    gcloud components install kubectl

  6. Scarica e installa git.

Creazione di un Dockerfile per l'app App Engine

Crea un Dockerfile per la tua app come descritto in Crea un Dockerfile.

Creazione di un container dal Dockerfile

Per creare un container:

  1. Assicurati di trovarti nella directory dell'app App Engine che contiene il Dockerfile.

  2. Modifica il progetto predefinito utilizzato dallo strumento gcloud in modo che punti al progetto che utilizzi per eseguire l'app in GKE:

    gcloud config set project [YOUR-PROJECT-ID]

    Sostituisci [YOUR-PROJECT-ID] con l'ID progetto GKE.

  3. Crea il container utilizzando il seguente comando:

    gcloud builds submit --tag gcr.io/[YOUR-PROJECT-ID]/[YOUR-CONTAINER-NAME] .

    Sostituisci [YOUR-PROJECT-ID] con l'ID progetto del tuo progetto GKE e [YOUR-CONTAINER-NAME] con il nome del container che vuoi utilizzare per il container dell'app.

  4. Attendi la creazione del container, che potrebbe richiedere del tempo. Al termine, viene visualizzato un messaggio simile a questo:

    Created [https://cloudbuild.googleapis.com/v1/projects/YOUR-PROJECT-ID/builds/xxxxxxx-xxxx-xxx-xxx-xxxxxxxxxxxx].
Logs are permanently available at [https://console.developers.google.com/logs/viewer?resource=build&project=YOUR-PROJECT-ID&filters=text:xxxx-xxx-xxx-xxxxxxxxxxxx]].

ID  CREATE_TIME DURATION  SOURCE                                                     IMAGES                               STATUS
xxxxxxx-xxxx-xxx-xxx-xxxxxxxxxxxx  2017-03-04T00:42:10+00:00  1M32S     gs://YOUR-PROJECT-ID_cloudbuild/source/xxxxxxx.08.tgz  gcr.io/YOUR-PROJECT-ID/YOUR-CONTAINER-NAME  SUCCESS<

    Prendi nota del nome del container: devi specificarlo quando lo esegui in GKE.

Eseguire l'app in GKE

Per eseguire il container che contiene l'app:

  1. Crea il cluster (l'operazione potrebbe richiedere alcuni minuti):

    gcloud container clusters create [YOUR-CLUSTER-NAME]

    Sostituisci [YOUR-CLUSTER-NAME] con il nome che vuoi assegnare al cluster.

  2. Dalla riga di comando, imposta la zona di computing:

    gcloud config set compute/zone us-central1-b

  3. Assicurati che lo strumento GKE kubectl sia autorizzato:

    gcloud container clusters get-credentials [YOUR-CLUSTER-NAME]

    Segui le istruzioni per autorizzare lo strumento.

  4. Esegui il container che contiene l'app:

    kubectl create deployment [YOUR-DEPLOYMENT-NAME] --image=gcr.io/[YOUR-PROJECT-ID]/[YOUR-CONTAINER-NAME]

    Sostituisci [YOUR-DEPLOYMENT-NAME] con il nome che vuoi utilizzare per il deployment, [YOUR-PROJECT-ID] con l'ID progetto GKE e [YOUR-CONTAINER-NAME] con il nome del contenitore che hai creato per la tua app.

  5. Esporre il contenitore per l'accesso pubblico:

    kubectl expose deployment [YOUR-DEPLOYMENT-NAME] --type="LoadBalancer" --port=8080

    Sostituisci [YOUR-DEPLOYMENT-NAME] con il nome che hai utilizzato nei passaggi precedenti. Potresti dover attendere alcuni minuti prima che l'IP esterno sia visibile.

  6. Visualizza l'indirizzo IP esterno della tua app:

    kubectl get service [YOUR-DEPLOYMENT-NAME]

    Sostituisci [YOUR-DEPLOYMENT-NAME] con il nome che hai utilizzato nei passaggi precedenti. Se il campo EXTERNAL IP è vuoto, attendi un po' e richiama il comando.

  7. Visualizza l'app in esecuzione in GKE:

    http://EXTERNAL-IP:8080

    Sostituisci EXTERNAL-IP con l'indirizzo IP esterno ottenuto nel passaggio precedente.

Hai eseguito il deployment e l'esecuzione dell'app App Engine su GKE.

Passaggi successivi

Ti consigliamo di scoprire di più su Kubernetes e sul comando kubectl. Google Kubernetes Engine utilizza Kubernetes per la gestione, il deployment e la scalabilità dei container. Per ulteriori informazioni su Kubernetes, visita il sito di Kubernetes esterno.

Questa guida utilizza kubectl, l'interfaccia a riga di comando per la gestione dei cluster Kubernetes. Per saperne di più su kubectl, consulta la documentazione di riferimento di kubectl.