Cosa devo fare se voglio ridistribuire la mia applicazione senza modificare le impostazioni di configurazione?

È sempre possibile distribuire l'applicazione con modifiche di configurazione modificando un valore di configurazione e distribuendo l'applicazione.

Tuttavia, è possibile ridistribuire una revisione dell'applicazione senza modificare le impostazioni di configurazione dell'applicazione. Forse la tua immagine del contenitore di riferimento è stata modificata e vuoi che la tua revisione dell'applicazione utilizzi l'immagine del contenitore aggiornata. Oppure, è possibile che si desideri che l'applicazione faccia riferimento a un segreto o a una configmap, che contiene valori di contenuto aggiornati.

Per questi scenari, dalla console, puoi fare clic su Ridistribuisci dalla scheda Configurazione della tua pagina dell'applicazione, senza modificare la configurazione dell'applicazione. Con la CLI, utilizza il comando ibmcloud ce app update.

Aggiornamento dell'app dalla console

Aggiorna l'applicazione che hai creato in Distribuzione di un'applicazione da un registro pubblico dalla console per aggiungere una variabile di ambiente.

1. Andate alla pagina della vostra candidatura. Un modo per passare alla pagina dell'applicazione è quello di
   • Individua la pagina dei progettiCode Engine.
   • Fare clic sul nome del progetto per aprire la pagina Panoramica.
   • Fare clic su Applicazioni per aprire un elenco delle applicazioni. Fare clic sul nome dell'applicazione per aprirne la pagina.
2. Dalla pagina dell'applicazione, puoi visualizzare le informazioni relative alle istanze in esecuzione della tua applicazione e alle sue revisioni, ai dettagli di configurazione e alle impostazioni dell'endpoint dell'applicazione. Fare clic sul nome della revisione dell'applicazione con cui si desidera lavorare per aprire il riepilogo di configurazione per tale revisione. In alternativa, è possibile fare clic sulla scheda Configurazione per aprire il riepilogo della configurazione per l'ultima revisione dell'applicazione.
3. Nella scheda Configurazione, fare clic su Variabili di ambiente.
4. Fare clic su Aggiungi variabile d'ambiente. Definire questa variabile di ambiente come valore letterale. Immettere TARGET come nome e Stranger come valore. Fai clic su Aggiungi.
5. Fare clic su Distribuisci per salvare la modifica e distribuire la revisione dell'applicazione.
6. Dopo che lo stato dell'applicazione è stato modificato in Pronto, è possibile verificare la revisione dell'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. Per questa app, viene visualizzato Hello Stranger.

In questo esempio, hai aggiornato le variabili di ambiente per un'applicazione. Puoi anche aggiornare altre impostazioni di configurazione per la tua applicazione, incluso il riferimento a un'immagine differente o una build dell'immagine differente dalla scheda Codice. Dalla scheda Risorse & scalabilità, puoi aggiornare le impostazioni di memoria e scalabilità dell'applicazione per la tua applicazione. Dalla scheda Variabili di ambiente, puoi aggiungere o aggiornare le variabili di ambiente per la tua applicazione. Dalla scheda Image start options, puoi aggiungere o aggiornare il comando e gli argomenti per sovrascrivere le impostazioni all'interno della tua immagine del contenitore o gestire i probe di attività e prontezza.

Aggiornamento della tua app per utilizzare gli endpoint di solo progetto dalla console

Per impostazione predefinita, quando distribuisci un'applicazione, l'applicazione viene distribuita in modo che possa ricevere richieste da Internet pubblico, da una rete privata o da componenti all'interno del progetto. Cambiamo la visibilità di questa applicazione in modo che sia accessibile solo da altre risorse Code Engine in esecuzione nello stesso ambiente Code Engine. Utilizzare la scheda Associazioni dominio per modificare la visibilità di una app.

1. Andate alla pagina della vostra candidatura. Un modo per passare alla pagina dell'applicazione è quello di

   • Individua la pagina dei progettiCode Engine.
   • Fare clic sul nome del progetto per aprire la pagina Panoramica.
   • Fare clic su Applicazioni per aprire un elenco delle applicazioni. Fare clic sul nome dell'applicazione per aprirne la pagina.

2. Dalla pagina dell'applicazione, puoi visualizzare le informazioni relative alle istanze in esecuzione della tua applicazione e alle sue revisioni, ai dettagli di configurazione e alle impostazioni dell'endpoint dell'applicazione. Fare clic sulla scheda Associazioni dominio per aprire le impostazioni di visibilità dell'endpoint per l'applicazione.

3. Dalla scheda Associazioni dominio, nota gli URL disponibili per la tua applicazione. Quando Public è selezionata, è possibile visualizzare l' URL di associazione del dominio del sistema pubblico e interno per l'applicazione. Quando si seleziona Nessuna mappatura di dominio del sistema esterno, questa applicazione non è più accessibile da internet pubblico e l'accesso alla rete è possibile solo dai componenti all'interno di questo progetto.

   Quando modifichi la visibilità della tua applicazione, la modifica è immediatamente effettiva. È importante considerare l'impatto della modifica per gli utenti attivi o le integrazioni, nonché eventuali implicazioni di sicurezza. È possibile modificare l'impostazione di visibilità come necessario.

Aggiornamento della tua applicazione per utilizzare gli endpoint privati dalla console

Per impostazione predefinita, quando distribuisci un'applicazione, l'applicazione viene distribuita in modo che possa ricevere richieste da Internet pubblico, da una rete privata o da componenti all'interno del progetto. Cambiamo la visibilità di questa applicazione in modo che sia accessibile solo da altre risorse Code Engine in esecuzione nello stesso progetto e dalla rete privata utilizzando i Virtual Private Endpoints. Utilizzare la scheda Associazioni dominio per modificare la visibilità di una app.

1. Andate alla pagina della vostra candidatura. Un modo per passare alla pagina dell'applicazione è quello di

   • Individua la pagina dei progettiCode Engine.
   • Fare clic sul nome del progetto per aprire la pagina Panoramica.
   • Fare clic su Applicazioni per aprire un elenco delle applicazioni. Fare clic sul nome dell'applicazione per aprirne la pagina.

2. Dalla pagina dell'applicazione, puoi visualizzare le informazioni relative alle istanze in esecuzione della tua applicazione e alle sue revisioni, ai dettagli di configurazione e alle impostazioni dell'endpoint dell'applicazione. Fare clic sulla scheda Associazioni dominio per aprire le impostazioni di visibilità dell'endpoint per l'applicazione.

3. Dalla scheda Associazioni dominio, nota gli URL disponibili per la tua applicazione. Quando si seleziona Private, questa applicazione non sarà più accessibile da Internet pubblico e l'accesso alla rete sarà possibile solo dai componenti all'interno di questo progetto (cluster-local) e dalla rete privata.

   Fai clic su Privato per modificare la visibilità dell'endpoint dell'app. Gli URL disponibili per la tua definizione di endpoint vengono visualizzati per gli URL privati e di solo progetto.

4. Per accedere alla tua applicazione in maniera sicura utilizzando un VPE (Virtual Private Endpoint), attieniti alle istruzioni per l'utilizzo del tuo VPE per accedere a un'applicazione per impostare il VPE per accedere alla tua applicazione.

Se imposti la tua applicazione per visibility = private, puoi testare la tua applicazione solo tramite l'endpoint privato virtuale dall'interno del tuo VPC(Virtual Private Cloud).

Modificando la visibilità della tua applicazione, la modifica è immediatamente effettiva. È importante considerare l'impatto della modifica per gli utenti attivi o le integrazioni, nonché eventuali implicazioni di sicurezza. È possibile modificare l'impostazione di visibilità come necessario.

Aggiornamento dell'applicazione con la CLI

Per aggiornare la tua applicazione con la CLI, utilizza il comando app update. Questo comando richiede il nome dell'applicazione che vuoi aggiornare e consente anche altri argomenti facoltativi. Per un elenco completo delle opzioni, consultare il comando ibmcloud ce app update.

Aggiorna l'applicazione che hai creato in Distribuzione di una applicazione con la CLI per aggiungere una variabile di ambiente.

L'immagine di esempio icr.io/codeengine/hello legge la variabile di ambiente TARGET e stampa Hello ${TARGET}. Se questa variabile d'ambiente è vuota, viene restituito Hello World. Il seguente esempio aggiorna l'applicazione per modificare il valore della variabile di ambiente TARGET in Stranger. Per ulteriori informazioni sul codice utilizzato per questo esempio, consultare hello.

1. Eseguire il application update il comando. Ad esempio,

   ibmcloud ce application update -n myapp --env TARGET=Stranger
   

   Output di esempio

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

2. Esegui il comando application get per visualizzare lo stato della tua applicazione, incluse le informazioni di revisione più recenti.

   ibmcloud ce application get --name myapp  
   

   Output di esempio

   [...]
   Name:          myapp
   [...]
   URL:           https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud
   Cluster Local URL:  http://myapp.4svg40kna19.svc.cluster.local
   Console URL:   https://cloud.ibm.com/codeengine/project/us-south/01234567-abcd-abcd-abcd-abcdabcd1111/application/myapp/configuration
   
   Environment Variables:
   Type     Name    Value
   Literal  TARGET  Stranger
   Image:                  icr.io/codeengine/hello
   Resource Allocation:
   CPU:                1
   Ephemeral Storage:  400M
   Memory:             4G
   
   Revisions:
   myapp-hc3u8-2:
       Age:                82s
       Traffic:            100%
       Image:              icr.io/codeengine/hello (pinned to f0dc03)
       Running Instances:  1
   
   Runtime:
   Concurrency:    100
   Maximum Scale:  10
   Minimum Scale:  0
   Timeout:        300
   
   Conditions:
   Type                 OK    Age  Reason
   ConfigurationsReady  true  75s
   Ready                true  62s
   RoutesReady          true  62s
   
   Events:
   Type    Reason   Age    Source              Messages
   Normal  Created  2m11s  service-controller  Created Configuration "myapp"
   Normal  Created  2m11s  service-controller  Created Route "myapp"
   
   Instances:
   Name                                       Revision       Running  Status       Restarts  Age
   myapp-hc3u8-1-deployment-65cf8cd4f5-jx8b8  myapp-hc3u8-1  1/2      Terminating  0         2m10s
   myapp-hc3u8-2-deployment-7f98b679d5-2hskr  myapp-hc3u8-2  2/2      Terminating  0         85s
   

   Dall'output nella sezione Revisioni, puoi visualizzare la revisione dell'applicazione più recente del servizio myapp. Inoltre, si noti che il 100% del traffico all'applicazione sta eseguendo l'ultima revisione dell'applicazione.

3. Chiamare l'applicazione.

   curl https://myapp.4svg40kna19.us-south.codeengine.appdomain.cloud
   

   Output di esempio

   Hello Stranger
   

   Dall'output di questo comando, puoi vedere che l'applicazione aggiornata ora restituisce Hello Stranger.

4. Utilizzare il comando ibmcloud ce revision list per visualizzare tutte le revisioni dell'applicazione. Utilizza queste informazioni per aiutarti a gestire le tue revisioni dell'applicazione come Code Engine ha una quota per il numero di revisioni dell'applicazione in un progetto.

   Nel seguente output revision list, tieni presente che Code Engine conserva solo l'ultima revisione inattiva della tua applicazione in aggiunta alla tua revisione dell'applicazione attiva. Le revisioni precedenti vengono eliminate.

   ibmcloud ce revision list
   

   Output di esempio

   Listing all application revisions...
   OK
   
   Name                   Application      Status  URL  Latest  Tag  Traffic  Age    Conditions  Reason
   myapp-hc3u8-4           myapp            Ready                            2d15h    3 OK / 4
   myapp-hc3u8-5           myapp            Ready        true         100%    2d8h    3 OK / 4  
   myapp2-vjfqt-1          myapp2           Ready        true         100%      3d    3 OK / 4
   myhelloapp-tv368-3      myhelloapp       Ready                              16d    3 OK / 4
   myhelloapp-tv368-4      myhelloapp       Ready        true         100%     16d    3 OK / 4
   newapp-mytest-00008     newapp-mytest    Ready                              4d17h  3 OK / 4
   newapp-mytest-00009     newapp-mytest    Ready        true         100%     2d20h  3 OK / 4
   

Puoi gestire le tue revisioni dell'applicazione utilizzando il comando ibmcloud ce revision get per visualizzare i dettagli di una revisione dell'applicazione e il comando ibmcloud ce revision delete per rimuovere le revisioni che non vuoi conservare. È inoltre possibile utilizzare il comando ibmcloud ce revision logs per visualizzare i log delle istanze di revisione dell'applicazione. Utilizzare il comando ibmcloud ce revision events per visualizzare gli eventi di sistema delle istanze di revisione dell'applicazione.

Aggiornamento della tua app per utilizzare gli endpoint solo progetto con la CLI

Per impostazione predefinita, quando distribuisci un'applicazione, l'applicazione viene distribuita in modo che possa ricevere richieste da Internet pubblico, da una rete privata o da componenti all'interno del progetto. Per modificare la visibilità della tua applicazione in modo che vi si acceda solo da altre risorse Code Engine in esecuzione nello stesso progetto, utilizza l'opzione --visibility=project con il comando ibmcloud ce app update o ibmcloud ce app create.

In questo scenario, aggiorna l'applicazione che hai creato in Distribuzione di una applicazione con la CLI per modificare la visibilità dell'applicazione in modo da utilizzare un endpoint del progetto .

1. Eseguire il application update il comando. Ad esempio,

   ibmcloud ce application update -n myapp --visibility=project
   

   Output di esempio

   Updating application 'myapp' to latest revision.
   [...]
   Run 'ibmcloud ce application get -n myapp' to check the application status.
   OK
   
   http://myapp.4svg40kna19.svc.cluster.local   
   

2. Esegui il comando application get per visualizzare lo stato della tua applicazione, incluse le informazioni di revisione più recenti.

   ibmcloud ce application get --name myapp  
   

   Output di esempio

   [...]
   Name:          myapp
   [...]
   URL:           http://myapp.4svg40kna19.svc.cluster.local
   Cluster Local URL:  http://myapp.4svg40kna19.svc.cluster.local
   Console URL:   https://cloud.ibm.com/codeengine/project/us-south/01234567-abcd-abcd-abcd-abcdabcd1111/application/myapp/configuration
   
   Environment Variables:
   Type     Name    Value
   Literal  TARGET  Stranger
   Image:                  icr.io/codeengine/hello
   Resource Allocation:
   CPU:                1
   Ephemeral Storage:  400M
   Memory:             4G
   
   Revisions:
   myapp-hc3u8-2:
       Age:                82s
       Traffic:            100%
       Image:              icr.io/codeengine/hello (pinned to f0dc03)
       Running Instances:  1
   
   Runtime:
   Concurrency:    100
   Maximum Scale:  10
   Minimum Scale:  0
   Timeout:        300
   
   Conditions:
   Type                 OK    Age  Reason
   ConfigurationsReady  true  75s
   Ready                true  62s
   RoutesReady          true  62s
   
   Events:
   Type    Reason   Age    Source              Messages
   Normal  Created  2m11s  service-controller  Created Configuration "myapp"
   Normal  Created  2m11s  service-controller  Created Route "myapp"
   
   Instances:
   Name                                       Revision       Running  Status       Restarts  Age
   myapp-hc3u8-1-deployment-65cf8cd4f5-jx8b8  myapp-hc3u8-1  1/2      Terminating  0         2m10s
   myapp-hc3u8-2-deployment-7f98b679d5-2hskr  myapp-hc3u8-2  2/2      Terminating  0         85s
   

   Dall'output nella sezione Revisioni, puoi visualizzare la revisione dell'applicazione più recente del servizio myapp. Inoltre, si noti che il 100% del traffico all'applicazione sta eseguendo l'ultima revisione dell'applicazione.

Ora che hai impostato --visibility=project sulla tua applicazione, questa applicazione non è più accessibile da internet pubblico e l'accesso alla rete è possibile solo dai componenti all'interno di questo progetto (cluster-local).

Aggiornamento dell'applicazione per utilizzare gli endpoint privati con la CLI

Per impostazione predefinita, quando distribuisci un'applicazione, l'applicazione viene distribuita in modo che possa ricevere richieste da Internet pubblico, da una rete privata o da componenti all'interno del progetto. Puoi configurare la visibilità dell'endpoint per la tua applicazione in modo che sia distribuita con un endpoint privato. L'impostazione di un endpoint privato significa che la tua applicazione non è accessibile da internet pubblico e l'accesso alla rete è possibile solo da altri componenti di IBM Cloud che sono in esecuzione nello stesso progetto (cluster-local).

Per modificare la visibilità della tua applicazione in modo che sia accessibile solo con un endpoint privato, utilizza l'opzione --visibility=private con il comando ibmcloud ce app update o ibmcloud ce app create.

Puoi utilizzare il tuo VPE solo per accedere alla tua applicazione con un endpoint privato se il tuo progetto selezionato supporta la visibilità privata dell'applicazione. Per confermare se il progetto supporta la visibilità privata dell'applicazione, utilizzare il comando ibmcloud ce project get per verificare che l'output per Application Private Visibility Supported sia impostato su true.

In questo scenario, aggiorna l'applicazione che hai creato in Distribuzione di una applicazione con la CLI per modificare la visibilità dell'applicazione in modo da utilizzare un endpoint privato.

1. Confermare che il progetto esistente supporta le applicazioni con visibilità privata. Utilizzare il comando ibmcloud ce project get per verificare che l'output per Application Private Visibility Supported sia impostato su true. Se il valore è false, contattare il supporto IBM per abilitare questa funzionalità all'interno del progetto esistente.

   ibmcloud ce project get -n myproject
   

   Output di esempio

   Getting project 'myproject'...
   OK
   
   Name:                                      myproject  
   ID:                         abcdabcd-abcd-abcd-abcd-f1de4aab5d5d
   Status:                                    active  
   Enabled:                                   true  
   Application Private Visibility Supported:  true  
   Selected:                                  true  
   Region:                                    us-south
   Resource Group:             default
   Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
   Age:                        52d
   Created:                                   Tue, 28 Sep 2021 05:12:16 -0500  
   Updated:                                   Tue, 28 Sep 2021 05:12:19 -0500  
   
   Quotas:    
   Category                                  Used  Limit  
   App revisions                             1     60  
   Apps                                      1     20  
   Build runs                                1     100  
   Builds                                    2     100  
   Configmaps                                2     100  
   CPU                                       0     64  
   Ephemeral storage                         0     256G  
   Instances (active)                        0     250  
   Instances (total)                         0     2500  
   Job runs                                  0     100  
   Jobs                                      0     100  
   Memory                                    0     256G  
   Secrets                                   6     100  
   Subscriptions (cron)                      0     100  
   Subscriptions (IBM Cloud Object Storage)  0     100  
   Subscriptions (Kafka)                     0     100
   

2. Se Application Private Visibility Supported è true, puoi aggiornare la tua applicazione per utilizzare gli endpoint privati. Eseguire il application update il comando. Ad esempio,

   ibmcloud ce application update -n myapp --visibility=private
   

   Output di esempio

   Updating application 'myapp' to latest revision.
   [...]
   Run 'ibmcloud ce application get -n myapp' to check the application status.
   OK
   
   https://myapp.4svg40kna19.private.us-south.codeengine.appdomain.cloud
   

3. Esegui il comando application get per visualizzare lo stato della tua applicazione, incluse le informazioni di revisione più recenti.

   ibmcloud ce application get --name myapp  
   

   Output di esempio

   [...]
   Name:          myapp
   [...]
   URL:           https://myapp.4svg40kna19.private.us-south.codeengine.appdomain.cloud
   Cluster Local URL:  http://myapp.4svg40kna19.svc.cluster.local
   Console URL:   https://cloud.ibm.com/codeengine/project/us-south/01234567-abcd-abcd-abcd-abcdabcd1111/application/myapp/configuration
   
   Environment Variables:
   Type     Name    Value
   Literal  TARGET  Stranger
   Image:                  icr.io/codeengine/hello
   Resource Allocation:
   CPU:                1
   Ephemeral Storage:  400M
   Memory:             4G
   
   Revisions:
   myapp-hc3u8-2:
       Age:                82s
       Traffic:            100%
       Image:              icr.io/codeengine/hello (pinned to f0dc03)
       Running Instances:  1
   
   Runtime:
   Concurrency:    100
   Maximum Scale:  10
   Minimum Scale:  0
   Timeout:        300
   
   Conditions:
   Type                 OK    Age  Reason
   ConfigurationsReady  true  75s
   Ready                true  62s
   RoutesReady          true  62s
   
   Events:
   Type    Reason   Age    Source              Messages
   Normal  Created  2m11s  service-controller  Created Configuration "myapp"
   Normal  Created  2m11s  service-controller  Created Route "myapp"
   
   Instances:
   Name                                       Revision       Running  Status       Restarts  Age
   myapp-hc3u8-1-deployment-65cf8cd4f5-jx8b8  myapp-hc3u8-1  1/2      Terminating  0         2m10s
   myapp-hc3u8-2-deployment-7f98b679d5-2hskr  myapp-hc3u8-2  2/2      Terminating  0         85s
   

   Dall'output nella sezione Revisioni, puoi visualizzare la revisione dell'applicazione più recente del servizio myapp. Inoltre, si noti che il 100% del traffico all'applicazione sta eseguendo l'ultima revisione dell'applicazione.

4. Configura il tuo VPE per accedere alla tua applicazione con un endpoint privato.

Aggiornamento di una app per fare riferimento a un'immagine differente

Puoi aggiornare la tua applicazione per fare riferimento a una diversa immagine.

L'immagine associata alla tua specifica revisione dell'applicazione ha un digest del registro del contenitore univoco e Code Engine utilizza questo digest per la durata della tua revisione dell'applicazione. Se crei una nuova versione di un'immagine con la stessa tag dell'immagine originale, l'immagine originale viene sovrascritta nel registro del contenitore e diventa senza tag. L'immagine più recente è taggata e questa immagine più recente ha un digest diverso. La tua applicazione Code Engine non utilizza questa immagine più recente, perché l'immagine più recente ha un digest differente rispetto all'immagine a cui fa riferimento la revisione dell'applicazione. Code Engine può ancora creare nuove istanze della revisione dell'applicazione finché l'immagine senza tag, a cui si fa riferimento in origine, esiste ancora. Per ulteriori informazioni, vedi Perché Code Engine non può eseguire il pull di un'immagine?