Crie uma configuração de construção que extraia a origem do repositório privado

Se a sua origem estiver localizada em um repositório privado, crie uma configuração de construção com definições que incluam informações sobre onde extrair a origem de um repositório privado. Para a saída de construção, é possível optar por especificar detalhes do registro juntamente com um segredo de registro para acessar sua imagem construída no registro Ou ainda, é possível optar por deixar que o Code Engine cuide da construção da imagem para você por meio sua origem e armazene a imagem no IBM Cloud Container Registry. Para esse caso, não é necessário especificar um segredo de registro ou o local do registro de imagem

A criação de uma configuração de construção não cria uma imagem, mas cria a configuração para construir uma imagem. Em seguida, deve-se executar uma construção que referencie a configuração de construção para criar uma imagem. A configuração de construção não é validada nem usada para criar uma imagem até que a construção seja executada. A configuração de construção possibilita várias construções subsequentes de uma imagem, como quando as mudanças são aplicadas ao repositório de origem.

É possível optar por ignorar certos padrões de arquivo de dentro do seu código-fonte usando o arquivo .ceignore, que se comporta de forma semelhante a um arquivo .gitignore. Por exemplo, entradas para um arquivo .ceignore para um aplicativo node.js podem incluir node_modules e .npm. Para obter mais padrões de arquivo de amostra a serem ignorados, consulte o GitHub.gitignore repository.

Criando uma configuração de construção por meio do console (repositório privado)

  1. Acesse o painel do Code Engine.

  2. Selecione o projeto no qual incluiu seu registro de contêiner.

  3. Na página de projeto, clique em Construções de imagem.

  4. Na guia Construção de imagem, clique em Criar. O painel lateral Especificar detalhes da construção abre e você insere os detalhes de sua construção.

  5. Na seção Origem, insira um nome para sua construção, a URL do seu repositório de origem e o seu acesso de repositório do código.

    • Se o seu código estiver em um repositório privado, use uma URL SSH para a URL do repositório de código e selecione o nome de um segredo SSH existente ou crie um segredo SSH. Um exemplo de uma URL SSH é git@github.com:IBM/CodeEngine.git.
    • Opcionalmente, selecione um nome de ramificação de origem. Se você não fornecer um nome de ramificação e deixar o campo vazio, o Code Engine usará automaticamente a ramificação padrão do repositório especificado. É possível inserir qualquer outro nome de ramificação, tag ou ID de confirmação.

    Clique em Avançar para continuar.

  6. Na seção Estratégia, selecione a estratégia que você deseja usar.

    • Se você selecionar Dockerfile, será possível também especificar um caminho alternativo para o seu Dockerfile.
    • Selecione o tamanho de sua construção em Recursos de construção.

    Clique em Avançar para avançar para a última seção.

  7. Na seção Saída, insira os detalhes da sua imagem de contêiner.

    • Selecione um segredo de registro existente ou clique em Criar segredo de registro para incluir um novo.
    • Se você estiver construindo sua imagem para uma instância Container Registry que está em sua conta, será possível selecionar Code Engine managed secret e Code Engine criar e gerenciar o segredo para você.
    • Em seguida, selecione o namespace, o repositório e a tag da imagem que você deseja construir. É possível escolher Code Engine para criar e gerenciar o namespace no Container Registry para você.
    • Se a sua imagem existir no Container Registry, será possível selecionar entre as imagens existentes ou inserir um novo repositório ou tag.

  8. Clique em Pronto para concluir a criação da construção.

Depois de criar a configuração de construção, deve-se executar a construção para criar o arquivo de imagem Depois que seu arquivo de imagem é criado, é possível implementar um aplicativo ou executar uma tarefa com seu arquivo de imagem recém-construído

Criando uma configuração de construção com a CLI (repositório privado)

Para criar uma configuração de construção com a CLI, use o comando build create. Para obter uma listagem completa de opções, consulte o comando ibmcloud ce build create.

Com o comando build create, é possível optar por deixar que o Code Engine cuide da construção da imagem para você por meio da sua origem e depois armazene a imagem no IBM Cloud Container Registry. Para esse caso de acesso automático, não é necessário especificar um segredo de registro ou o local do registro da imagem Ou, é possível especificar o local para sua saída de imagem de construção e fornecer um segredo de registro para que o Code Engine possa acessar e enviar por push o resultado de construção para seu registro.

Criando uma configuração de construção com a CLI (com origem de repositório privado e acesso automático ao registro)

Neste cenário, o Code Engine constrói uma imagem por meio da origem de repositório privado e automaticamente faz upload da imagem para o IBM Cloud Container Registry. Consulte Configurando autoridades para registros de imagem para obter mais informações sobre a configuração de permissões necessárias para o Code Engine acessar automaticamente essas imagens no Container Registry.

Antes de Iniciar

Crie uma configuração de construção para construir uma imagem por meio de um repositório privado e deixe que o Code Engine armazene e acesse a imagem automaticamente. Por exemplo, o comando build create a seguir cria uma configuração de construção que é chamada helloworld-build-private que constrói por meio do repositório Git privado https://github.com/myprivaterepo/builds, e usa a estratégia buildpacks e o tamanho de construção medium. O Code Engine automaticamente faz upload da imagem para o IBM Cloud Container Registry. Também, como o nome da ramificação do repositório não é especificado com a opção --commit, o Code Engine usa automaticamente a ramaficação padrão do repositório especificado, que é main para este repositório Git. Ao não especificar o local do registro de imagem ou um segredo de registro, Code Engine envia por push a saída de construção para IBM Cloud Container Registry com acesso automático.

Como o repositório Git fornecido é privado, o acesso requer um segredo do repositório Git. Como resultado, o --source que você especificar deve usar o protocolo SSH, como git@github.com:myprivaterepo/builds.git. O valor para --source não deve usar o formato http ou https.

ibmcloud ce build create --name helloworld-build-private --source git@github.com:myprivaterepo/builds.git --context-dir /hello --strategy buildpacks --git-repo-secret myrepo

Depois de criar a configuração de construção, deve-se executar a construção para criar o arquivo de imagem Depois que seu arquivo de imagem é criado, é possível implementar um aplicativo ou executar uma tarefa com seu arquivo de imagem recém-construído

Criando uma configuração de construção com a CLI (com origem de repositório privado e acesso ao registro fornecido pelo usuário)

Neste cenário, o Code Engine constrói uma imagem por meio da origem de repositório privado com um segredo de repositório Git que você fornece e, em seguida, faz upload da imagem para o seu registro de contêiner com o acesso ao registro que você fornece.

Antes de Iniciar

Crie uma configuração da construção para construir uma imagem de um repositório privado e especifique o local do registro da imagem para a saída da construção com um segredo de registro. Com o comando build create, especifique a opção --image para fornecer o local do registro da imagem, e especifique a opção --registry-secret para acessar o registro. Por exemplo, o comando a seguir cria uma configuração de construção chamada helloworld-build-private que constrói a partir do Git repo https://github.com/myprivaterepo/builds privado, usa a estratégia buildpacks e o tamanho da construção medium e armazena a imagem no us.icr.io/mynamespace/codeengine-helloworld usando o segredo de registro definido em myregistry.

Como o repositório Git fornecido é privado, o acesso requer um segredo do repositório Git. Como resultado, o --source que você especificar deve usar o protocolo SSH, como git@github.com:myprivaterepo/builds.git. O valor para --source não deve usar o formato http ou https.

Neste exemplo, o comando usa o tamanho de construção medium padrão. Como o nome da ramificação do repositório não é especificado com a opção --commit, o Code Engine usa automaticamente a ramificação padrão do repositório especificado.

ibmcloud ce build create --name helloworld-build-private --image us.icr.io/mynamespace/codeengine-helloworld --registry-secret myregistry --source git@github.com:myprivaterepo/builds.git --context-dir /hello --strategy buildpacks --git-repo-secret myrepo

Depois de criar a configuração de construção, deve-se executar a construção para criar o arquivo de imagem Depois que seu arquivo de imagem é criado, é possível implementar um aplicativo ou executar uma tarefa com seu arquivo de imagem recém-construído