Criando um mapa de configuração com a CLI

Crie um configmap com o comando configmap create de uma das formas a seguir,

• Crie um configmap diretamente na linha de comandos usando a opção --from-literal no formato KEY=VALUE. Por exemplo,

  ibmcloud ce configmap create --name myliteralconfigmap --from-literal TARGET=Sunshine
  

• Crie um configmap usando a opção --from-file para apontar para um arquivo. Ao utilizar esta opção, todo o conteúdo do arquivo se torna o valor para o par chave-valor. Para este exemplo, use um arquivo denominado colors.txt, que contém o texto blue, green, red.

  • O exemplo a seguir usa o formato --from-file KEY=FILE com o comando configmap create:

    ibmcloud ce configmap create --name mycolorconfigmap --from-file TARGET=colors.txt
    

  • O comando de exemplo a seguir usa o formato --from-file FILE com o comando configmap create. Neste exemplo, TARGET (sem extensão) é o nome do arquivo, que é o mesmo nome da variável de ambiente que é conhecido para o exemplo de tarefa myjob.

    ibmcloud ce configmap create --name mycolorconfigmap2  --from-file TARGET
    

• Crie um configmap usando a opção --from-env-file para apontar para um arquivo que contenha uma ou mais linhas que correspondem ao formato KEY=VALUE. Cada linha do arquivo especificado é incluída como um par chave-valor. Quaisquer linhas no arquivo especificado que estejam vazias ou começam com # serão ignoradas. Para este exemplo, use um arquivo denominado colors_multi.txt que contém os pares chave-valor: color1=yellow, color2=orange e color3=purple.

  ibmcloud ce configmap create --name mycolorconfigmapmulti --from-env-file colors_multi.txt
  

Listando os configmaps com a CLI

Agora que o configmap está criado, use o comando configmap list para listar todos os configmaps em seu projeto ou use o comando configmap get para exibir detalhes sobre um configmap específico. Por exemplo,

ibmcloud ce configmap get --name mycolorconfigmap

Saída de exemplo

Getting configmap 'mycolorconfigmap'...
OK

Name:          mycolorconfigmap
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           11s
Created:       2020-10-14 14:10:57 -0400 EDT

Data:
---
TARGET: blue, green, red

Referência os configmaps existentes com a CLI

Para usar um configmap com uma carga de trabalho de app, tarefa ou função com a CLI, especifique a opção --env-from-configmap nos comandos a seguir.

• app create
• app update
• job create
• job update
• jobrun submit
• jobrun resubmit
• fn create
• fn update

O exemplo a seguir descreve como fazer referência a um configmap existente com um aplicativo usando a CLI.

1. Use o comando configmap create para criar os dois configmaps a seguir para este cenário.

   ibmcloud ce configmap create --name myliteralconfigmap --from-literal TARGET=Sunshine
   

   ibmcloud ce configmap create --name myliteralconfigmap2 --from-literal TARGET=Stranger
   

2. Implemente um aplicativo e faça referência ao configmap myliteralconfigmap. Para este exemplo, crie um app que utilize a imagem hello. Quando uma solicitação for enviada para esse app de amostra, o app lerá a variável de ambiente TARGET e imprimirá Hello ${TARGET}. Se esta variável de ambiente estiver vazia, Hello World será retornado. Faça referência ao configmap myliteralconfigmap. Para obter mais informações sobre o código usado para este exemplo, consulte hello.

   ibmcloud ce app create --name myhelloapp --image icr.io/codeengine/hello --env-from-configmap myliteralconfigmap
   

3. Chame o aplicativo. O aplicativo retorna Hello Sunshine, que é o valor para a chave TARGET que é especificado no configmap myliteralconfigmap.

   curl https://myhelloapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud
   

   Saída de exemplo

   Hello Sunshine
   

4. Atualize o aplicativo novamente para usar o configmap myliteralconfigmap2.

   Quando você atualiza um aplicativo, tarefa ou função com uma variável de ambiente que referencia totalmente um configmap (ou segredo) para referenciar totalmente um configmap (ou segredo) diferente, as referências completas substituem outras referências completas na ordem em que elas são configuradas (o último conjunto referenciado substitui o primeiro conjunto).

   ibmcloud ce app update --name myhelloapp --env-from-configmap myliteralconfigmap2
   

   Saída de exemplo

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

5. Chame o aplicativo novamente. Desta vez, o aplicativo retornará Hello Stranger, que é o valor que é especificado no configmap myliteralconfigmap2.

   curl https://myhelloapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud  
   

   Saída de exemplo

   Hello Stranger
   

6. Atualize o myliteralconfigmap2 para alterar o par chave-valor.

   ibmcloud ce configmap update --name myliteralconfigmap2 --from-literal "TARGET=Happy day"
   

   Execute o comando ibmcloud ce configmap get -n myliteralconfigmap2 para exibir detalhes do configmap.

   Saída de exemplo

   Name:          myliteralconfigmap2
   [...]
   Data:
   ---
   TARGET: Happy day
   

7. Reinicie o aplicativo para que os novos dados entrem em vigor.

   ibmcloud ce app update --name myhelloapp
   

8. Chame o aplicativo novamente. Desta vez, o aplicativo retornará Hello Happy day, que é o valor que é especificado no configmap myliteralconfigmap2.

   curl https://myhelloapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud  
   

   Saída de exemplo

   Hello Happy day
   

Como fazer referência aos configmaps que ainda não estão definidos na CLI

Se um configmap não existir antes de ser referenciado, a carga de trabalho de aplicativo, tarefa ou função não será implementada com êxito e uma tarefa ou função não será executada com êxito até que o configmap referenciado seja criado.

Se você estiver trabalhando com uma carga de trabalho de app, tarefa ou função e o configmap referenciado ainda não estiver definido, será possível usar a opção --force para evitar a verificação da existência do configmap referenciado. A opção --force pode ser usada com os comandos a seguir:

• app create
• app update
• job create
• job update
• jobrun submit
• jobrun resubmit
• fn create
• fn update

Ao usar a opção --force com esses comandos, a ação para criar, atualizar ou executar a carga de trabalho é concluída; no entanto, o app, a tarefa ou a carga de trabalho não será executada com êxito até que o configmap referenciado exista.. Se você incluir a opção --no-wait além da opção --force no comando, o sistema concluirá a ação e não esperará a execução bem-sucedida da carga de trabalho.

O exemplo a seguir descreve como fazer referência a um configmap que ainda não está definido em um aplicativo usando a CLI.

1. Crie um aplicativo e faça referência ao configmap indefinido myliteralconfigmap3. Para este exemplo, crie um app Code Engine que use a imagem icr.io/codeengine/hello. Quando uma solicitação for enviada para esse app de amostra, o app lerá a variável de ambiente TARGET e imprimirá Hello ${TARGET}. Se esta variável de ambiente estiver vazia, Hello World será retornado. Faça referência ao configmap myliteralconfigmap3. Para obter mais informações sobre o código usado para este exemplo, consulte hello.

   Ao usar a opção --no-wait com o comando app create, o aplicativo será criado e não esperará que o aplicativo esteja pronto.

   ibmcloud ce app create --name myapp --image icr.io/codeengine/hello --env-from-configmap myliteralconfigmap3 --force --no-wait
   

2. Use o comando app get para exibir detalhes da execução da tarefa, incluindo as informações da variável de ambiente. Observe que o aplicativo foi criado, mas ainda não foi totalmente implementado.

   ibmcloud ce app get --name myapp
   

   Saída de exemplo

   Name:            myapp
   [...]
   Status Summary:  Application is deploying
   
   Environment Variables:
       Type                      Name                 Value
       ConfigMap full reference  myliteralconfigmap3
   Image:                  icr.io/codeengine/hello
   Resource Allocation:
       CPU:                1
       Ephemeral Storage:  400M
       Memory:             4G
   
   Runtime:
       Concurrency:    100
       Maximum Scale:  10
       Minimum Scale:  0
       Timeout:        300
   
   Conditions:
       Type                 OK     Age  Reason
       ConfigurationsReady  false  10s
       Ready                false  10s  RevisionMissing : Configuration "myapp" is waiting for a Revision to become ready.
       RoutesReady          false  10s  RevisionMissing : Configuration "myapp" is waiting for a Revision to become ready.
   
   Events:
       Type    Reason   Age  Source              Messages
       Normal  Created  12s  service-controller  Created Configuration "myapp"
       Normal  Created  12s  service-controller  Created Route "myapp"
   
   Instances:
       Name                                      Revision      Running  Status   Restarts  Age
       myapp-00001-deployment-566d5c79b9-wttqs  myapp-00001  0/2      Pending  0         11s
   

3. Crie o configmap.

   ibmcloud ce configmap create --name myliteralconfigmap3 --from-literal TARGET=Everyone
   

4. Reinicie o aplicativo para que os novos dados entrem em vigor.

   ibmcloud ce app update --name myapp
   

5. Chame o aplicativo. O aplicativo retornará Hello Everyone, que é o valor especificado no configmap myliteralconfigmap3.

   curl https://myapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud  
   

   Saída de exemplo

   Hello Everyone
   

6. Atualize o aplicativo para fazer referência ao configmap myliteralconfigmap2 existente. O myliteralconfigmap2 é definido com o valor TARGET=Stranger. A atualização do aplicativo reinicia o aplicativo para que os novos dados entrem em vigor.

   Ao atualizar um aplicativo ou tarefa com uma variável de ambiente que referencia totalmente um configmap (ou segredo) a fim de referenciar totalmente um configmap (ou segredo) diferente, as referências integrais substituem outras referências integrais na ordem em que elas são configuradas (o último conjunto referenciado substitui o primeiro conjunto).

   ibmcloud ce app update --name myapp --env-from-configmap myliteralconfigmap2
   

7. Chame o aplicativo novamente. Desta vez, o aplicativo retornará Hello Stranger, que é o valor que é especificado no configmap myliteralconfigmap2.

   curl https://myapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud  
   

   Saída de exemplo

   Hello Stranger
   

Para obter cenários mais detalhados sobre referenciar segredos e mapas de configuração integrais como variáveis de ambiente, substituição de referências e remoção de referências na CLI, consulte Referenciando segredos e mapas de configuração.