Crea una configurazione di build che estrae l'origine dal repository privato

Se la tua origine si trova in un repository privato, crea una configurazione di build con le impostazioni che includono le informazioni su dove estrarre l'origine da un repository privato. Per l'output di build, puoi scegliere di specificare i dettagli del registro insieme a un segreto del registro per accedere alla tua immagine creata nel registro. Oppure puoi scegliere di consentire a Code Engine di creare l'immagine per te dalla tua origine e archiviarla in IBM Cloud Container Registry. In questo caso, non è necessario specificare un segreto del Registro di sistema o l'ubicazione del Registro immagini.

La creazione di una configurazione di build non crea un'immagine, bensì la configurazione per creare un'immagine. È necessario quindi eseguire una build che fa riferimento alla configurazione di build per creare una immagine. La configurazione di build non viene convalidata o utilizzata per creare un'immagine fino a quando non viene eseguita la build. La configurazione di build abilita più build successive di un'immagine, ad esempio quando le modifiche vengono applicate al repository di origine.

È possibile scegliere di ignorare alcuni pattern di file dall'interno del codice sorgente utilizzando il file .ceignore, che si comporta in modo simile a un file .gitignore. Ad esempio, le entrate per un file .ceignore per un'applicazione node.js potrebbero includere node_modules e .npm. Per ulteriori modelli di file di esempio da ignorare, vedi GitHub.gitignore repository.

Creazione di una configurazione di build dalla console (repository privato)

Vai al dashboard Code Engine.
Seleziona il progetto in cui hai aggiunto il tuo registro del contenitore.
Dalla pagina del progetto, fare clic su Build immagine.
Dalla scheda Image build, fai clic su Create. Il pannello laterale Specifica dettagli di build si apre dove si immettono i dettagli della build.
Nella sezione Source, immetti un nome per la tua build, l'URL del tuo repository di origine e l'accesso al tuo repository di codice.
- Se il tuo codice si trova in un repository privato, utilizza un URL SSH per l'URL del repository di codice e seleziona il nome di un segreto SSH o crea un segreto SSH. Un esempio di URL SSH è git@github.com:IBM/CodeEngine.git.
- Facoltativamente, selezionare un nome ramo di origine. Se non fornisci un nome di ramo e lasci il campo vuoto, Code Engine utilizza automaticamente il ramo predefinito del repository specificato. È possibile immettere qualsiasi altro nome di ramo, tag o ID commit.
Fai clic su Next per continuare.
Nella sezione Strategia, selezionare la strategia che si desidera utilizzare.
- Se selezioni Dockerfile, puoi specificare anche un percorso alternativo per il tuo Dockerfile.
- Seleziona la dimensione della tua build in Build resources.
Fare clic su Avanti per passare all'ultima sezione.
Nella sezione Output, immetti i dettagli della tua immagine del contenitore.
- Selezionare un segreto del Registro di sistema esistente o fare clic su Crea segreto del Registro di sistema per aggiungerne uno nuovo.
- Se stai creando la tua immagine in un'istanza Container Registry presente nel tuo account, puoi selezionare Code Engine managed secret e Code Engine crea e gestisce il segreto per te.
- Seleziona quindi lo spazio dei nomi, il repository e la tag dell'immagine che vuoi creare. Puoi scegliere che Code Engine crei e gestisca lo spazio dei nomi in Container Registry per te.
- Se la tua immagine esiste in Container Registry, puoi selezionare dalle immagini esistenti o immettere un nuovo repository o tag.
Fare clic su Fine per terminare la creazione della build.

Dopo aver creato la configurazione di build, è necessario eseguire la creazione per creare il file immagine. Una volta creato il tuo file di immagine, puoi distribuire un'applicazione o eseguire un lavoro con il tuo file di immagine appena creato.

Creazione di una configurazione di build con la CLI (repository privato)

Per creare una configurazione di build con la CLI, utilizza il comando build create. Per un elenco completo delle opzioni, consultare il comando ibmcloud ce build create.

Con il comando build create, puoi scegliere di lasciare che Code Engine si occupi di creare l'immagine dalla tua origine e archiviarla in IBM Cloud Container Registry. Per questo caso di accesso automatico, non è necessario specificare un segreto di registro o l'ubicazione del registro delle immagini. Oppure, puoi specificare l'ubicazione per il tuo output dell'immagine di build e fornire un segreto del Registro di sistema in modo che Code Engine possa accedere e inviare il risultato della build al tuo Registro di sistema.

Creazione di una configurazione di build con la CLI (con origine del repository privato e accesso automatico al registro)

In questo scenario, Code Engine crea un'immagine dalla tua origine del repository privato e carica automaticamente l'immagine in IBM Cloud Container Registry. Vedi Configurazione delle autorizzazioni per i registri delle immagini per ulteriori informazioni sull'impostazione delle autorizzazioni richieste per Code Engine per accedere automaticamente a queste immagini in Container Registry.

Prima di iniziare

Crea una configurazione di build per creare una immagine da un repository privato e lascia che Code Engine memorizzi e acceda automaticamente all'immagine. Ad esempio, il seguente comando build create crea una configurazione di build denominata helloworld-build-private che crea dal repository Git privato https://github.com/myprivaterepo/builds e utilizza la strategia buildpacks e la dimensione di build medium. Code Engine carica automaticamente l'immagine in IBM Cloud Container Registry. Inoltre, poiché il nome del ramo del repository non viene specificato con l'opzione --commit, Code Engine utilizza automaticamente il ramo predefinito del repository specificato, che è main per questo repository Git. Non specificando l'ubicazione del registro delle immagini o di un segreto del registro, Code Engine invia l'output di build a IBM Cloud Container Registry con accesso automatico.

Poiché il repository Git fornito è privato, l'accesso richiede un segreto del repository Git. Di conseguenza, il --source che specifichi deve utilizzare il protocollo SSH, come ad esempio git@github.com:myprivaterepo/builds.git. Il valore per --source non deve utilizzare il formato http o 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

Creazione di una configurazione di build con la CLI (con origine del repository privato e accesso fornito dall'utente al registro)

In questo scenario, Code Engine crea un'immagine dall'origine del tuo repository privato con il segreto del repository Git che fornisci e quindi carica l'immagine nel tuo registro del contenitore con l'accesso al registro che fornisci.

Prima di iniziare

Crea una configurazione di build per creare una immagine da un repository privato e specifica l'ubicazione del registro di immagini per l'output di build con un segreto di registro. Con il comando build create, specifica l'opzione --image per fornire l'ubicazione del registro delle immagini e specifica l'opzione --registry-secret per accedere al registro. Ad esempio, il seguente comando crea una configurazione di build denominata helloworld-build-private che crea dal repository Git privato https://github.com/myprivaterepo/builds, utilizza la strategia buildpacks e la dimensione di build medium e archivia l'immagine in us.icr.io/mynamespace/codeengine-helloworld utilizzando il segreto di registro definito in myregistry.

In questo esempio, il comando utilizza la dimensione di build medium predefinita. Poiché il nome del ramo del database non è specificato con l'opzione --commit, Code Engine utilizza automaticamente il ramo predefinito del repository specificato.

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