E se eu desejar reimplementar meu aplicativo sem mudar as configurações?

É possível sempre implementar seu aplicativo com mudanças na configuração mudando um valor de configuração e implementando o aplicativo.

No entanto, talvez você queira reimplementar uma revisão de aplicativo sem alterar as definições da configuração do aplicativo Talvez sua imagem de contêiner referenciada tenha mudado e você deseja que a revisão do aplicativo use a imagem de contêiner atualizada. Ou, talvez você queira que seu aplicativo faça referência a um segredo ou configmap, que contém valores de conteúdo atualizados

Para esses cenários, no console, é possível clicar em Reimplementar na guia Configuração de sua página do aplicativo, sem mudar a configuração do app Com a CLI, use o comando ibmcloud ce app update.

Atualizando seu app por meio do console

Atualize o aplicativo que você criou em Implementando um aplicativo a partir de um registro público a partir do console para incluir uma variável de ambiente.

1. Navegue para a página do aplicativo. Uma maneira de navegar para a página do aplicativo é
   • Localize a página Code Engine Projetos.
   • Clique no nome do seu projeto para abrir a página Overview (Visão geral).
   • Clique em Aplicativos para abrir uma lista de seus aplicativos. Clique no nome de seu aplicativo para abrir sua página de aplicativo.
2. Na página do aplicativo, é possível visualizar informações sobre as instâncias de execução de seu aplicativo e suas revisões, detalhes de configuração e configurações de terminais do app. Clique no nome da revisão do aplicativo com a qual deseja trabalhar para abrir o resumo da configuração dessa revisão. Ou, é possível clicar na aba Configuração para abrir o resumo de configuração para a revisão mais recente do aplicativo.
3. Na guia Configuração, clique na guia Variáveis de ambiente
4. Clique em Incluir variável de ambiente. Defina esta variável de ambiente como um valor literal. Insira TARGET para o nome e Stranger para o valor. Clique em Incluir.
5. Clique em Deploy para salvar as alterações e implementar a revisão do aplicativo.
6. Após o status do aplicativo mudar para Pronto, é possível testar a revisão do aplicativo. Clique em Testar aplicativo e, em seguida, clique em Enviar solicitação na área de janela Testar aplicativo. Para abrir o aplicativo em uma página da web, clique em URL do aplicativo. Para este app, Hello Stranger é exibido.

Neste exemplo, você atualizou variáveis de ambiente para um app. Também é possível atualizar outras definições de configuração para o seu app, incluindo referência a uma imagem diferente ou compilação de imagem diferente a partir da guia Código. Na guia Recursos e ajuste de escala, é possível atualizar as configurações de memória e ajuste de escala do aplicativo para seu app. A partir da aba Variáveis de ambiente, é possível incluir ou atualizar as variáveis de ambiente para o seu app. Na guia Opções de início da imagem, é possível incluir ou atualizar comando e argumentos para substituir as configurações dentro de sua imagem de contêiner ou trabalhar com análises de atividade e prontidão.

Atualizando seu app para usar terminais apenas de projeto por meio do console

Por padrão, ao implementar um app, o app é implementado de tal forma que pode receber solicitações da Internet pública, de uma rede privada ou de componentes dentro do projeto. Vamos mudar a visibilidade deste app para que ele seja acessado apenas por outros recursos do Code Engine que estão em execução no mesmo ambiente do Code Engine. Use a guia Mapeamentos de domínio para alterar a visibilidade de um aplicativo.

1. Navegue para a página do aplicativo. Uma maneira de navegar para a página do aplicativo é

   • Localize a página Code Engine Projetos.
   • Clique no nome do seu projeto para abrir a página Overview (Visão geral).
   • Clique em Aplicativos para abrir uma lista de seus aplicativos. Clique no nome de seu aplicativo para abrir sua página de aplicativo.

2. Na página do aplicativo, é possível visualizar informações sobre as instâncias de execução de seu aplicativo e suas revisões, detalhes de configuração e configurações de terminais do app. Clique na guia Domain mappings (Mapeamentos de domínio ) para abrir as configurações de visibilidade do endpoint para o aplicativo.

3. Na guia Domain mappings (Mapeamentos de domínio ), observe os URLs disponíveis para seu aplicativo. Quando Public é selecionado, é possível visualizar a URL do mapeamento de domínio do sistema público e interno para o aplicativo Quando No external system domain mapping (Nenhum mapeamento de domínio de sistema externo ) é selecionado, esse aplicativo não pode mais ser acessado pela Internet pública e o acesso à rede só é possível a partir de componentes desse projeto.

   Quando você altera a visibilidade do seu aplicativo, a alteração entra em vigor imediatamente. É importante considerar o impacto da mudança para os seus usuários ativos ou integrações, bem como quaisquer implicações de segurança. É possível mudar a configuração de visibilidade conforme a necessidade.

Atualizando seu app para usar terminais privados do console

Por padrão, ao implementar um app, o app é implementado de tal forma que pode receber solicitações da Internet pública, de uma rede privada ou de componentes dentro do projeto. Vamos mudar a visibilidade deste app de tal forma que ele seja acessado apenas por outros recursos do Code Engine que estão executando no mesmo projeto e por meio da rede privada usando terminais privados virtuais. Use a guia Mapeamentos de domínio para alterar a visibilidade de um aplicativo.

1. Navegue para a página do aplicativo. Uma maneira de navegar para a página do aplicativo é

   • Localize a página Code Engine Projetos.
   • Clique no nome do seu projeto para abrir a página Overview (Visão geral).
   • Clique em Aplicativos para abrir uma lista de seus aplicativos. Clique no nome de seu aplicativo para abrir sua página de aplicativo.

2. Na página do aplicativo, é possível visualizar informações sobre as instâncias de execução de seu aplicativo e suas revisões, detalhes de configuração e configurações de terminais do app. Clique na guia Domain mappings (Mapeamentos de domínio ) para abrir as configurações de visibilidade do endpoint para o aplicativo.

3. Na guia Domain mappings (Mapeamentos de domínio ), observe os URLs disponíveis para seu aplicativo. Quando Private é selecionado, este aplicativo não é mais acessível por meio da Internet pública e o acesso à rede só é possível por meio de componentes dentro deste projeto (local do cluster) e da rede privada.

   Clique em Privado para mudar a visibilidade do terminal do app. As URLs disponíveis para sua definição de terminal são exibidas para as URLs privadas e somente de projeto.

4. Para acessar o seu app de forma segura usando um VPE (terminal privado virtual), siga as instruções para Usando seu VPE para acessar um app para configurar o VPE para acessar seu app.

Se você configurar o seu aplicativo para visibility = private, então você só poderá testar seu aplicativo por meio do terminal privado virtual de dentro de sua Virtual Private Cloud (VPC).

Ao mudar a visibilidade do seu app, a mudança é efetivada imediatamente. É importante considerar o impacto da mudança para os seus usuários ativos ou integrações, bem como quaisquer implicações de segurança. É possível mudar a configuração de visibilidade conforme a necessidade.

Atualizando seu app com a CLI

Para atualizar o seu app com a CLI, use o comando app update. Esse comando requer o nome do app que você deseja atualizar e também permite outros argumentos opcionais. Para obter uma listagem completa de opções, consulte o comando ibmcloud ce app update.

Atualize o aplicativo criado em Implementando um aplicativo com a CLI para incluir uma variável de ambiente.

A imagem icr.io/codeengine/hello da amostra lê a variável de ambiente TARGET e imprime Hello ${TARGET}. Se a variável de ambiente estiver vazia, Hello World será retornado. O exemplo a seguir atualiza o app para modificar o valor da variável de ambiente TARGET para Stranger. Para obter mais informações sobre o código usado para este exemplo, consulte hello.

1. Execute o comando application update. Por exemplo,

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

   Saída de exemplo

   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. Execute o comando application get para exibir o status de seu app, incluindo as informações de revisão mais recentes.

   ibmcloud ce application get --name myapp  
   

   Saída de exemplo

   [...]
   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
   

   Na saída na seção Revisões, é possível ver a revisão de aplicativo mais recente do serviço myapp. Além disso, observe que 100% do tráfego para o aplicativo está executando a revisão mais recente do app.

3. Chame o aplicativo.

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

   Saída de exemplo

   Hello Stranger
   

   Na saída deste comando, agora é possível ver o app atualizado retornar Hello Stranger.

4. Use o comando ibmcloud ce revision list para exibir todas as suas revisões de app. Use essas informações para ajudá-lo a gerenciar suas revisões de aplicativo, pois Code Engine tem uma cota para o número de revisões de aplicativo em um projeto.

   Na saída da revision list a seguir, observe que o Code Engine retém apenas a revisão inativa mais recente de seu aplicativo, além de sua revisão ativa do app. As revisões mais antigas são excluídas.

   ibmcloud ce revision list
   

   Saída de exemplo

   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
   

É possível gerenciar suas revisões de app usando o comando ibmcloud ce revision get para exibir detalhes de uma revisão de app e o comando ibmcloud ce revision delete para remover revisões que você não deseja manter. Também é possível usar o comando ibmcloud ce revision logs para visualizar logs de instâncias de revisão de aplicativos. Use o comando ibmcloud ce revision events para exibir eventos do sistema de instâncias de revisão de aplicativos.

Atualizando seu app para usar terminais somente de projeto com a CLI

Por padrão, ao implementar um app, o app é implementado de tal forma que pode receber solicitações da Internet pública, de uma rede privada ou de componentes dentro do projeto. Para mudar a visibilidade de seu app de forma que ele seja acessado apenas por outros recursos do Code Engine que estão em execução no mesmo projeto, use a opção --visibility=project com o comando ibmcloud ce app update ou ibmcloud ce app create

Neste cenário, atualize o aplicativo que você criou em Implementando um aplicativo com a CLI para mudar a visibilidade do app para usar um terminal do projeto.

1. Execute o comando application update. Por exemplo,

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

   Saída de exemplo

   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. Execute o comando application get para exibir o status de seu app, incluindo as informações de revisão mais recentes.

   ibmcloud ce application get --name myapp  
   

   Saída de exemplo

   [...]
   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
   

   Na saída na seção Revisões, é possível ver a revisão de aplicativo mais recente do serviço myapp. Além disso, observe que 100% do tráfego para o aplicativo está executando a revisão mais recente do app.

Agora que você configurou o --visibility=project em seu aplicativo, este aplicativo não é mais acessível por meio da Internet pública e o acesso à rede só é possível por meio componentes dentro deste projeto (local do cluster).

Atualizando seu app para usar terminais privados com a CLI

Por padrão, ao implementar um app, o app é implementado de tal forma que pode receber solicitações da Internet pública, de uma rede privada ou de componentes dentro do projeto. É possível configurar a visibilidade do terminal para o seu app de tal forma que ele seja implementado com um terminal privado. Configurar um terminal privado significa que seu app não é acessível por meio Internet pública e o acesso à rede só é possível por meio de outros serviços do IBM Cloud de terminais privados virtuais (VPC) ou de componentes do Code Engine que estão em execução no mesmo projeto (local do cluster).

Para mudar a visibilidade de seu app para que ele seja acessado somente com um terminal privado, use a opção --visibility=private com o comando ibmcloud ce app update ou ibmcloud ce app create.

Somente é possível usar o seu VPE para acessar o seu app com um terminal privado se o seu projeto selecionado suportar visibilidade privada do aplicativo. Para confirmar se o projeto suporta visibilidade privada de aplicativo, use o comando ibmcloud ce project get para verificar se a saída para Application Private Visibility Supported está configurada como true.

Neste cenário, atualize o aplicativo que você criou em Implementando um aplicativo com a CLI para mudar a visibilidade do app para usar um terminal privado.

1. Confirme se o projeto existente suporta aplicativos com visibilidade privada. Use o comando ibmcloud ce project get para verificar a saída para Application Private Visibility Supported é definida como true. Se o valor for false, entre em contato com o suporte IBM para ativar essa capacidade dentro do seu projeto existente.

   ibmcloud ce project get -n myproject
   

   Saída de exemplo

   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 for true, será possível atualizar seu app para usar terminais privados. Execute o comando application update. Por exemplo,

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

   Saída de exemplo

   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. Execute o comando application get para exibir o status de seu app, incluindo as informações de revisão mais recentes.

   ibmcloud ce application get --name myapp  
   

   Saída de exemplo

   [...]
   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
   

   Na saída na seção Revisões, é possível ver a revisão de aplicativo mais recente do serviço myapp. Além disso, observe que 100% do tráfego para o aplicativo está executando a revisão mais recente do app.

4. Configure o VPE para acessar seu app com um terminal privado.

Atualizando um app para referenciar uma imagem diferente

É possível atualizar o seu app para referenciar uma imagem diferente

A imagem associada à sua revisão de aplicativo específica tem uma compilação de registro de contêiner exclusiva e o Code Engine usa essa compilação para a vida de sua revisão de aplicativo. Se você criar uma versão mais recente de uma imagem com a mesma tag que a imagem original, a imagem original será sobrescrita no registro de contêiner e se tornará não identificada A imagem mais recente é identificada e essa imagem mais recente tem uma compilação diferente.... Seu aplicativo Code Engine não usa essa imagem mais recente, porque a imagem mais nova tem uma compilação diferente da imagem referenciada pela revisão do aplicativo. Code Engine ainda pode criar novas instâncias da revisão do aplicativo, desde que a imagem não identificada, que foi referenciada originalmente, ainda exista. Para obter mais informações, consulte Por que o Code Engine não pode extrair uma imagem?