Distribuzione dei carichi di lavoro dell'applicazione dalle immagini in un registro pubblico

Distribuisci la tua app con Code Engine. È possibile creare un'app dalla console o con la CLI.

Distribuzione di un'applicazione dalla console

Distribuire un'applicazione utilizzando un'immagine proveniente da un registro pubblico che non richieda credenziali tramite la console Code Engine.

Questo esempio fa riferimento all'immagine icr.io/codeengine/helloworld pubblica in IBM Cloud® Container Registry. In alternativa, puoi anche fare riferimento a un'immagine in un Docker Hub pubblico o un'immagine in un registro privato.

Apri la console Code Engine.
Seleziona " Inizia a creare ".
Seleziona un progetto dall'elenco dei progetti disponibili. È anche possibile crearne uno nuovo. È necessario disporre di un progetto selezionato per distribuire un'applicazione.
Seleziona " Applicazione ".
Inserisci un nome per l'applicazione. Assegna alla tua applicazione un nome che sia univoco all'interno del progetto.
Specifica un'immagine del contenitore per la tua applicazione, ad esempio icr.io/codeengine/helloworld. Se hai il tuo proprio codice sorgente che vuoi trasformare in un'immagine del contenitore per l'applicazione, vedi Pianificazione della tua build. Per ulteriori informazioni sul codice utilizzato per questo esempio, consultare helloworld.
Modificare i valori predefiniti per le impostazioni di endpoint o runtime. Per ulteriori informazioni su queste opzioni, consulta Opzioni per la visibilità dell'endpoint delle applicazioni e Opzioni per la distribuzione di un'applicazione.
Fai clic su Crea.
Una volta modificato lo stato dell'applicazione in Pronto, è possibile verificare l'applicazione. Fare clic su Applicazione di test, quindi fare clic su Invia richiesta nel riquadro Applicazione di test. Per aprire l'applicazione in una pagina web, fare clic su Applicazione URL.

Ora che hai distribuito la tua applicazione, puoi visualizzare le informazioni sulle revisioni dell'applicazione e qualsiasi istanza in esecuzione e i dettagli di configurazione.

Distribuzione di un'applicazione con la CLI

Per creare e distribuire la tua applicazione con la CLI, utilizza il comando app create. Questo comando richiede un nome e un'immagine e consente anche altri argomenti facoltativi. Per un elenco completo delle opzioni, consultare il comando ibmcloud ce app create.

Prima di iniziare

Imposta il tuo ambiente CLICode Engine.
Creare e utilizzare un progetto.

Il seguente comando application create crea e distribuisce un'applicazione denominata myapp e utilizza l'immagine del contenitore icr.io/codeengine/hello.

ibmcloud ce application create --name myapp --image icr.io/codeengine/hello

Output di esempio

Creating application 'myapp'...
OK
[...]
Run 'ibmcloud ce application get -n myapp' to check the application status.
OK
https://myapp.4idmmq6xpss.us-south.codeengine.appdomain.cloud

La seguente tabella riepiloga le opzioni utilizzate con il comando app create in questo esempio. Per ulteriori informazioni sul comando e le sue opzioni, consultare il comando ibmcloud ce app create.

Descrizione del comando
Opzione	Descrizione
`--name`	Il nome dell'applicazione. Utilizzare un nome univoco all'interno del progetto. Questo valore è obbligatorio. Il nome deve iniziare con una lettera minuscola. Il nome deve terminare con un carattere alfanumerico minuscolo. Il nome deve essere di 55 caratteri o meno e può contenere lettere, numeri e trattini (-).
`--image`	Il nome dell'immagine utilizzata per questa applicazione. Questo valore è obbligatorio. Il formato è `REGISTRY/NAMESPACE/REPOSITORY:TAG`, dove `REGISTRY` e `TAG` sono facoltativi. Se non viene specificato `TAG`, il valore predefinito è `latest`. Per le immagini in Docker Hub, puoi specificare l'immagine con `NAMESPACE/REPOSITORY`, poiché il valore predefinito per `Registry` è `docker.io`. Per altri registri, utilizzare `REGISTRY/NAMESPACE/REPOSITORY` o `REGISTRY/NAMESPACE/REPOSITORY:TAG`.

Passi successivi

Dopo aver distribuito l'app, accedi all'app tramite un URL.
Puoi creare un' associazione dominio personalizzata e assegnarla alla tua applicazione. Per ulteriori informazioni sulla distribuzione delle applicazioni tra più regioni con un nome dominio personalizzato, vedi Configurazione di un'applicazione altamente disponibile.
Ora che la tua app è stata distribuita, prendi in considerazione la possibilità di rendere le tue app basate sugli eventi. Utilizzando le sottoscrizioni agli eventi, puoi attivare le tue applicazioni in base alle pianificazioni periodiche o impostare la tua applicazione per reagire agli eventi come i caricamenti di file o i messaggiKafka.

Dopo che la tua applicazione è stata distribuita, puoi aggiornare la tua applicazione distribuita e il suo codice di riferimento utilizzando uno qualsiasi dei seguenti modi, indipendentemente da come hai creato o precedentemente aggiornato la tua applicazione:

Se hai un'immagine del contenitore, secondo lo standard OCI(Open Container Initiative), devi fornire solo un riferimento all'immagine, che punta all'ubicazione del tuo registro del contenitore quando distribuisci la tua applicazione. Puoi distribuire la tua applicazione con una immagine in un registro pubblico o in un registro privato.

Se hai creato la tua applicazione utilizzando il comando app create e hai specificato l'opzione --build-source per creare l'immagine del contenitore dall'origine locale o del repository e vuoi modificare la tua applicazione in modo che punti a un'altra immagine del contenitore, devi prima rimuovere l'associazione della build dalla tua applicazione. Ad esempio, eseguire ibmcloud ce application update -n APP_NAME --build-clear. Dopo aver rimosso l'associazione della build dalla propria applicazione, è possibile aggiornare l'applicazione in modo che faccia riferimento a una diversa immagine.
Se stai iniziando con il codice sorgente che risiede in un repository Git, puoi scegliere di lasciare che Code Engine si occupi della creazione dell'immagine dalla tua origine e della distribuzione dell'applicazione con una singola operazione. In questo scenario, Code Engine carica la tua immagine in IBM Cloud® Container Registry. Per ulteriori informazioni, vedi Distribuzione della tua applicazione dal codice sorgente del repository. Se vuoi più controllo sulla build della tua immagine, puoi scegliere di creare l'immagine con Code Engine prima di distribuire la tua applicazione.
Se stai iniziando con il codice sorgente che risiede su una workstation locale, puoi scegliere di consentire a Code Engine di creare l'immagine dalla tua origine e distribuire l'applicazione con un singolo comando della CLI. In questo scenario, Code Engine carica la tua immagine in IBM Cloud® Container Registry. Per ulteriori informazioni, vedi Distribuzione della tua applicazione dal codice di origine locale con la CLI. Se vuoi più controllo sulla build della tua immagine, puoi scegliere di creare l'immagine con Code Engine prima di distribuire la tua applicazione.

Ad esempio, potresti scegliere di consentire a Code Engine di gestire la creazione della tua origine locale mentre evolvi lo sviluppo della tua origine per l'applicazione. Quindi, una volta maturata l'immagine, puoi aggiornare l'applicazione distribuita per fare riferimento all'immagine specifica che desideri. È possibile ripetere questo processo in base alle necessità.

Quando distribuisci la tua applicazione aggiornata, viene scaricata e distribuita l'ultima versione della tua immagine del contenitore di riferimento, a meno che non venga specificata una tag per l'immagine. Se viene specificata una tag per l'immagine, l'immagine contrassegnata viene utilizzata per la distribuzione.

Cerchi altri esempi di codice? Dai un'occhiata agli esempi disponibili nel repository " IBM Cloud Code Engine " su GitHub.