Creazione di un'applicazione Go

Specifica della versione Go

Per impostazione predefinita, il buildpack Go utilizza la versione stabile più recente del compilatore Go. Se la tua applicazione richiede una versione specifica, puoi utilizzare la variabile d'ambiente GOOGLE_GO_VERSION per fornire un vincolo semver che verrà utilizzato per selezionare una versione di Go disponibile.

pack build sample-go --builder=gcr.io/buildpacks/builder \
  --env GOOGLE_GO_VERSION="17.x.x"

Flag di compilazione

Il buildpack Go compila l'origine dell'applicazione in un eseguibile utilizzando go build command. Per configurare il comportamento di compilazione, puoi utilizzare le seguenti variabili di ambiente:

  • GOOGLE_BUILDABLE Specifica il percorso di un'unità generabile. Esempio: ./maindir per Go compilerà il pacchetto con root in maindir.

  • GOOGLE_CLEAR_SOURCE Ometti il codice sorgente dall'immagine dell'applicazione. Se l'applicazione dipende da file statici, ad esempio i modelli Go, l'impostazione di questa variabile potrebbe causare un malfunzionamento dell'applicazione. Esempio: true, True, 1 cancellerà l'origine.

  • GOOGLE_GOGCFLAGS Passato a go build e go run come valore -gcflags senza alcuna interpretazione. Esempio: all=-N -l abilita l'analisi delle condizioni di gara e modifica il modo in cui i percorsi dei file di origine vengono registrati nel file binario.

  • GOOGLE_GOLDFLAGS Passato per la build e l'esecuzione come valore -ldflags senza alcuna interpretazione. Esempio: -s -w viene utilizzato per rimuovere e ridurre le dimensioni binarie.

Gestione delle dipendenze

Ti consigliamo di utilizzare i moduli Go per gestire le dipendenze nella tua app Go. Il buildpack Go utilizza il comando go build per compilare l'app e quindi corrisponde al comportamento di Go stesso. Per assicurarti che la tua app utilizzi la modalità consapevole dei moduli, devi includere un file go.mod nella directory principale dell'applicazione.

Dipendenze dal fornitore

Il vendoring copia i pacchetti utilizzati dalla tua app nella directory dell'applicazione anziché scaricare i moduli dalle relative origini durante il processo di compilazione. Go fornisce il comando go build per fornire i pacchetti necessari alla tua app in una directory denominata vendor nella directory root dell'app.

Configura il punto di ingresso dell'applicazione

Per impostazione predefinita, il buildpack Go configurerà la voce del container dell'applicazione che richiama l'eseguibile main generato durante la compilazione dell'origine dell'applicazione. Se devi eseguire l'override, puoi farlo specificando un valore Procfile o passando la variabile di ambiente GOOGLE_ENTRYPOINT.

Variabili di ambiente

Il buildpack Go supporta le seguenti variabili di ambiente per personalizzare il container

VAI

Consulta la documentazione di Go sulle variabili di ambiente

Esempio: GOFLAGS=-flag=value trasmette -flag=value ai comandi go.