Questa pagina spiega come utilizzare i generatori forniti dalla community e i builder personalizzati in Cloud Build. La La community di sviluppatori Cloud Build offre open source costruttori che puoi utilizzare per eseguire le tue attività. Se l'attività che vuoi eseguire richiede funzionalità non offerte da un'immagine esistente, puoi creare personalizzata e usarla in un passaggio di build. Per conoscere i diversi tipi di consulta Cloud Builder.
Se non hai mai utilizzato Cloud Build, leggi le guide rapide. e Panoramica della configurazione della build.
Utilizzo di builder forniti dalla community
Le immagini predefinite non sono disponibili per i builder forniti dalla community. per utilizzare in un file di configurazione di Cloud Build, devi prima creare ed eseguine il push in Container Registry nel tuo progetto.
Per utilizzare un builder fornito dalla community:
Crea ed esegui il push del builder:
Vai alla directory root del progetto.
Clona il repository cloud-builders-community:
git clone https://github.com/GoogleCloudPlatform/cloud-builders-community.git
Vai all'immagine del builder che vuoi utilizzare, dove builder-name è la directory che contiene il builder:
cd cloud-builders-community/builder-name
Invia il builder al progetto:
gcloud builds submit .
Torna alla directory principale del progetto:
cd ../..
Rimuovi il repository dalla directory root:
rm -rf cloud-builders-community/
Nel file di configurazione di Cloud Build, utilizza il builder in un passaggio di build:
YAML
steps: - name: 'gcr.io/project-id/builder-name' args: ['arg1', 'arg2', ...] ...
JSON
{ "steps": [ { "name": "gcr.io/project-id/builder-name", "args": [ "arg1", "arg2", ... ] ... } ] }
Utilizza il file di configurazione della build per avviare la build manualmente o creare utilizzando i trigger.
Per esempi sull'utilizzo dei builder forniti dalla community, vedi Eseguire il deployment in Firebase e Creare immagini VM con Packer.
Creazione di un builder personalizzato
Se l'attività che vuoi eseguire richiede funzionalità non fornite un'immagine pubblica, un builder supportato o un buider dato dalla community, puoi creare la tua immagine e usarla in un passaggio di creazione.
Ecco alcuni esempi di quando utilizzare un'immagine del generatore personalizzato:
- Download di pacchetti o codice sorgente da posizioni esterne.
- Utilizzo di una catena di strumenti esterna.
- Memorizzazione nella cache di tutte le librerie necessarie.
- Origine della pre-creazione (con Cloud Build responsabile solo potenzialmente pacchettizza la build in un'immagine).
Come qualsiasi altro builder, viene eseguito un builder personalizzato con l'origine montata in
/workspace
e viene eseguito con una directory di lavoro in /workspace
. Eventuali file rimanenti
in /workspace
per un determinato passaggio di build sono disponibili per altri passaggi di build.
Il tuo builder personalizzato può eseguire il push o il pull da un repository in
Container Registry (ospitato in gcr.io/$PROJECT-NAME/
)
a cui il tuo account di servizio Cloud Build ha
l'accesso.
I passaggi seguenti mostrano come creare e utilizzare un generatore personalizzato con un esempio
Dockerfile
:
Crea un'immagine del builder personalizzato:
Crea il
Dockerfile
per il generatore personalizzato. Le seguenti il codice mostra un esempioDockerfile
:FROM alpine RUN apk add curl CMD curl https://httpbin.org/ip -s > myip.txt; echo "*** My IP is: $(cat myip.txt)"
Crea ed esegui il push del builder personalizzato in Container Registry nel tuo progetto, sostituzione dei valori di project-id e image-name:
gcloud builds submit --tag gcr.io/project-id/image-name
Usa l'immagine del builder personalizzato in Cloud Build specificando il builder nel campo
name
di un passaggio di build:YAML
steps: - name: 'gcr.io/project-id/image-name' id: Determine IP of this build worker
JSON
{ "steps": [ { "name": "gcr.io/project-id/image-name", "id": "Determine IP of this build worker" } ] }
Utilizza il file di configurazione della build per avviare la build manualmente o creare utilizzando i trigger.
Passaggi successivi
- Scopri come eseguire script bash nei passaggi di build.
- Scopri come configurare l'ordine dei passaggi di build.
- Scopri come scrivere un file di configurazione della build di base.