Criando um botão Implementar no IBM Cloud

O botão Implementar no IBM Cloud é uma maneira eficiente de compartilhar o seu app público originado no Git para que outras pessoas possam ter experiência com o código e implementá-lo no IBM Cloud usando uma cadeia de ferramentas. O botão requer configuração mínima e é possível inseri-lo em qualquer lugar que suporte marcação. Qualquer pessoa que clica no botão cria uma cópia clonada do código em um novo repositório Git (repositório) para que seu app original não seja afetado.

Quando alguém clica em seu botão, ocorrem estas ações:

Se a pessoa não tiver uma conta ativa do IBM Cloud, ela deverá criar uma conta. Ela pode criar uma conta para teste ou uma conta real.
É possível selecionar uma região, um grupo de recursos e o nome do aplicativo clicando no ícone do Delivery Pipeline. O nome do app sugerido é o mesmo que o nome da cadeia de ferramentas, que é construído do nome de seu repositório Git original e a horário. O nome da cadeia de ferramentas também pode ser editado.
Cria-se uma cadeia de ferramentas que inclui um novo clone privado do seu repo Git, um pipeline para construção e implementação de alterações de código, e um rastreador de emissão.

Se o diretório .bluemix contiver um arquivo toolchain.yml, o arquivo será usado para especificar as integrações da ferramenta para a cadeia de ferramentas. Para obter mais informações sobre o arquivo toolchain.yml , consulte “Criação de modelos personalizados de cadeia de ferramentas ”.
Se o app requer um arquivo de construção, o arquivo de construção é detectado automaticamente e o app é construído.
Se um pipeline é configurado para o processo de construção e implementação, um arquivo pipeline.yml é usado para implementar o app.
Se o app requerer um contêiner, um arquivo pipeline.yml que define o IBM Cloud Kubernetes Service e um Dockerfile que define uma imagem serão usados para implementar o app no IBM Cloud Kubernetes Service.
O app é implementado na organização do IBM Cloud que a pessoa selecionou.

Exemplos do botão

DevOps Insights chegará ao fim de sua vida útil e será descontinuado em 31 de agosto de 2026. O serviço Continuous Delivery será descontinuado nas seguintes regiões em 12 de fevereiro de 2027: au-syd, ca-tor, us-east. O Code Risk Analyzer também será descontinuado em todas as regiões nessa data. Se uma região não apresentar uso ativo desses recursos, os recursos nessa região poderão ser descontinuados mais cedo e deixar de aceitar novas instâncias. Saiba mais

Veja um exemplo do botão de app para um repositório Git Repos and Issue Tracking público:

Veja um exemplo do botão de app para um repositório GitHub público:

Criando um botão

Para criar um botão Implementar no IBM Cloud, copie e modifique um dos modelos de fragmento a seguir. Especifique um repositório Git e ramificação na URL.

Criando um botão em HTML

Para criar um botão em HTML, copie este fragmento e insira uma URL do repositório Git público e ramificação.

<a href="https://cloud.ibm.com/devops/setup/deploy?repository=<git_repository_URL>&branch=<git_branch>"><img src="https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg" alt="Deploy to IBM Cloud" target="_blank"></a>

Se você não incluir o parâmetro branch na URL do repositório do seu snippet, o botão Implementar no IBM Cloud, por padrão, será configurado para a ramificação mestre do repositório.

Criando um botão em Markdown

Para criar um botão em Markdown, copie este fragmento e insira uma URL do repositório Git público e ramificação.

[![Deploy to IBM Cloud button](https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg)](https://cloud.ibm.com/devops/setup/deploy?repository=<git_repository_URL>&branch=<git_branch>)

Se você não incluir o parâmetro branch na URL do repositório do seu snippet, o botão Implementar no IBM Cloud, por padrão, será configurado para a ramificação mestre do repositório.

Usando os fragmentos do botão

Após você criar um fragmento de botão Implementar no IBM Cloud, será possível inseri-lo em blogs, artigos, wikis, arquivos leia-me ou em qualquer lugar no qual você desejar promover o seu app.

Ao personalizar o trecho de código do botão “Implantar no IBM Cloud ”, leve em consideração que ambos os modelos utilizam um caminho padrão para uma imagem externa do botão no formato SVG e em inglês. Se você preferir armazenar a imagem localmente, será possível fazer download da imagem e armazená-la no repositório Git. Ajuste o caminho para usar o local relativo da imagem.

Considerações de repositório

Revise estas considerações para o repositório que você usa em seu botão Implementar no IBM Cloud.

Requisitos do arquivo de construção

Se o app deve ser construído antes de poder ser implementado, deve-se incluir um arquivo de construção em seu repositório. Se um arquivo do script de construção é detectado no diretório-raiz do repositório, uma construção automatizada do código é acionada antes da implementação.

Os construtores suportados incluem:

Ant: build.xml, que gera os arquivos de saída na pasta ./output/
Gradle: /build.gradle, que gera os arquivos de saída na pasta .
Grunt: /Gruntfile.js, que constrói saída para a pasta .
Maven: /pom.xml, que gera os arquivos de saída na pasta ./target/

Requisitos do arquivo de pipeline

Para configurar o pipeline para a cadeia de ferramentas em um diretório .bluemix, inclua um arquivo pipeline.yml. Para cada arquivo pipeline.yml nesse diretório, um pipeline é criado quando a cadeia de ferramentas é instanciada.

Para criar um arquivo de pipeline, consulte o arquivo de exemplo na documentação “Criação de modelos personalizados de toolchain ”. Assim como quando define um pipeline na interface da web, você define um pipeline em texto criando estágios e tarefas, configurando entradas e variáveis de ambiente e incluindo scripts. Você também pode ver vários arquivos de pipeline mais complexos neste projeto de demonstração.

Requisitos do Container Dockerfile

Para implementar um app em um contêiner usando o IBM Cloud Kubernetes Service, deve-se incluir um Dockerfile no diretório raiz do repositório e, em um diretório .bluemix, incluir um arquivo pipeline.yml.

O Dockerfile age como uma espécie de script de construção para o app. Se um Dockerfile é detectado no repositório, o app é construído automaticamente em uma imagem antes que seja implementado em um contêiner. Se o próprio app precisar ser construído antes de o app ser construído em uma imagem, inclua um script de construção para o app e um Dockerfile.

Para saber mais sobre como criar arquivos Dockerfile, consulte a documentação do Docker. Para saber mais sobre Kubernetes, consulte IBM Cloud Serviço Kuberenetes.

Para criar manualmente um pipeline.yml específico para contêineres, consulte os exemplos em GitHub.