Implementando cargas de trabalho de app por meio de imagens em um registro público

Implemente seu app com o Code Engine. É possível criar um aplicativo no console ou com a CLI.

Implementando um app por meio do console

Implemente um aplicativo com uma imagem por meio de um registro público que não necessita de credenciais com o console do Code Engine.

Este exemplo referencia uma imagem icr.io/codeengine/helloworld pública em IBM Cloud® Container Registry. Também é possível referenciar uma imagem em um Docker Hub público ou em uma imagem em um registro privado.

Abra o console Code Engine.
Selecione “Começar a criar ”.
Selecione um projeto na lista de projetos disponíveis. Também é possível criar um novo. Deve-se ter um projeto selecionado para implementar um app.
Selecione Aplicativo.
Insira um nome para o aplicativo. Use um nome para seu aplicativo que seja exclusivo dentro do projeto.
Especifique uma imagem de contêiner para seu app, por exemplo, icr.io/codeengine/helloworld. Se você tiver seu próprio código-fonte e quiser transformá-lo em uma imagem de contêiner para o aplicativo, consulte “Planejando sua compilação ”. Para obter mais informações sobre o código que é usado para este exemplo, consulte helloworld.
Modifique quaisquer valores padrão para configurações de terminal ou de tempo de execução. Para obter mais informações sobre essas opções, consulte Opções para visibilidade de terminais de apps e Opções para implementar um app.
Clique em Criar.
Após o status do aplicativo mudar para Pronto, será possível testar o 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.

Agora que você implementou seu aplicativo, é possível visualizar informações sobre as revisões do aplicativo e quaisquer instâncias em execução, além de detalhes de configuração.

Implementando um app com a CLI

Para criar e implementar o seu app com a CLI, use o comando app create. Esse comando requer um nome e uma imagem e também permite outros argumentos opcionais. Para obter uma listagem completa de opções, consulte o comando ibmcloud ce app create.

Antes de Iniciar

Configure o seu ambiente da CLI do Code Engine.
Criar e trabalhar com um projeto.

O comando application create a seguir cria e implementa um app que é denominado myapp e usa a imagem do contêiner icr.io/codeengine/hello.

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

Saída de exemplo

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

A tabela a seguir resume as opções que são usadas com o comando app create neste exemplo. Consulte o comando ibmcloud ce app create para obter mais informações sobre ele e as opções que ele oferece.

Descrição do comando
Opção	Descrição
`--name`	O nome do aplicativo. Use um nome que seja exclusivo dentro do projeto. Esse valor é necessário. -O nome deve começar com uma letra minúscula. -O nome deve terminar com um caractere alfanumérico minúscula. -O nome deve ter 55 caracteres ou menos e pode conter letras, números e hifens (-).
`--image`	O nome da imagem que é usada para este aplicativo. Este valor é necessário. O formato é `REGISTRY/NAMESPACE/REPOSITORY:TAG` em que `REGISTRY` e `TAG` são opcionais. Se `TAG` não for especificado, o padrão será `latest`. Para imagens no Hub do Docker, você pode especificar a imagem com `NAMESPACE/REPOSITORY`, já que o padrão para `Registry` é `docker.io`. Para outros registros, use `REGISTRY/NAMESPACE/REPOSITORY` ou `REGISTRY/NAMESPACE/REPOSITORY:TAG`.

Próximas etapas

Após a implementação do app, acesse-o por meio de uma URL.
É possível criar um mapeamento de domínio customizado e designá-lo ao seu app Para obter mais informações sobre a implementação de apps em diversas regiões com um nome de domínio customizado, consulte Configurando um aplicativo altamente disponível
Agora que seu aplicativo está implantado, considere torná-lo orientado a eventos. Usando assinaturas de eventos, é possível acionar seus apps por planejamentos periódicos ou configurar seu app para reagir a eventos como uploads de arquivos ou mensagens doKafka.

Após a implementação do app, também é possível atualizar o app implementado e seu código referenciado usando qualquer uma das maneiras a seguir, independentemente de como você criou ou atualizou previamente seu app:

Se você tiver uma imagem de contêiner, de acordo com o padrão da Open Container Initiative(OCI), basta fornecer apenas uma referência à imagem, que aponte para o local do seu registro de contêineres ao implantar seu aplicativo. Você pode implementar o seu app com uma imagem em um registro público ou registro privado.

Se você criou o seu app usando o comando app create e especificou a opção --build-source para construir a imagem do container a partir de origem local ou repositório, e deseja alterar seu app para apontar para uma imagem de contêiner diferente, deve-se primeiro remover a associação da construção a partir do seu app. Por exemplo, execute ibmcloud ce application update -n APP_NAME --build-clear. Depois de remover a associação da construção a partir do seu app, você pode atualizar o app para referencia uma imagem diferente.
Se você está começando com código-fonte que reside em um repositório Git, é possível optar por deixar que o Code Engine cuide da construção da imagem por meio de sua origem e implemente o app com uma operação única. Neste cenário, o Code Engine faz upload da sua imagem para o IBM Cloud® Container Registry. Para saber mais, consulte Implementando seu app por meio do código-fonte do repositório. Se você quiser mais controle sobre a construção da sua imagem, poderá optar por construir a imagem com o Code Engine antes de implementar seu app.
Se você está começando com código-fonte que reside em uma estação de trabalho local, é possível optar por deixar que o Code Engine cuide da construção da imagem por meio de sua origem e implemente o app com um comando da CLI único. Neste cenário, o Code Engine faz upload da sua imagem para o IBM Cloud® Container Registry. Para saber mais, consulte Implementando seu app por meio do código-fonte local com a CLI. Se você quiser mais controle sobre a construção da sua imagem, poderá optar por construir a imagem com o Code Engine antes de implementar seu app.

Por exemplo, você pode optar por deixar que o Code Engine cuide da construção de sua origem local enquanto você cuida do desenvolvimento de sua origem para o app. Em seguida, após o amadurecimento da imagem, é possível atualizar o app implementado para referenciar a imagem específica que desejar. É possível repetir esse processo conforme necessário.

Ao implementar seu app atualizado, a versão mais recente de sua imagem de contêiner referenciada é transferida por download e implementada, a menos que uma tag seja especificada para a imagem. Se uma tag for especificada para a imagem, a imagem marcada será usada para a implementação.

Procurando mais exemplos de código? Confira os exemplos no repositório “ IBM Cloud Code Engine ” GitHub.