Specifica delle dipendenze

Le app che vengono eseguite nel runtime standard di Go 1.11 possono utilizzare qualsiasi pacchetto compatibile con linux/amd64.

Utilizzo dei moduli Go

Ti consigliamo di utilizzare i moduli Go per gestire le dipendenze nella tua app Go, ma puoi continuare a utilizzare la modalità GOPATH precedente se non è ancora il momento di eseguire la migrazione ai moduli Go.

Quando esegui il deployment dell'app, App Engine utilizza il comando go build per compilarla e quindi corrisponde al comportamento di Go stesso. Per assicurarti che la tua app utilizzi la modalità consapevole dei moduli, svolgi i seguenti passaggi nell'ambiente di sviluppo:

• Crea il file go.mod del modulo nella stessa directory del file app.yaml. App Engine cerca nella directory corrente e poi nelle directory principali successive finché non trova un file go.mod.

  Se App Engine non trova un file go.mod, segue la modalità GOPATH.

• Se imposti la variabile di ambiente GO111MODULE, assicurati che il valore della variabile attivi la modalità consapevole dei moduli. Quando esegui il deployment dell'app, App Engine controlla se GO111MODULE è presente nel tuo ambiente e ne associa il comportamento a quello di Go. App Engine applica l'impostazione della variabile GO111MODULE solo se hai incluso un file go.mod per la tua app.

• Non posizionare la directory dell'app in $GOPATH/src o al di sotto. Se la tua app si trova in qualsiasi punto della struttura ad albero della directory $GOPATH/src, App Engine segue la modalità GOPATH anche se hai definito un file go.mod per la tua app.

Utilizzo di dipendenze private

App Engine non può scaricare le dipendenze private durante il processo di compilazione, pertanto devi includerle nel codice dell'applicazione al momento del deployment.

Per dichiarare le dipendenze private, dovrai utilizzare l'istruzione replace nel file go.mod. Nell'esempio seguente si presuppone che l'app si trovi nella directory /myapp/:

1. Passa alla directory dell'app:

   cd /myapp
   

2. Crea una directory contenente le dipendenze private:

   mkdir private
   

   Assicurati che la dipendenza privata sia nella directory private. Un approccio è creare un link simbolico:

   mkdir private/private.example.com
   ln -s /path/to/private.example.com/foo private/private.example.com/foo
   

3. Aggiorna il file go.mod in modo da utilizzare la direttiva replace per utilizzare la directory private per la dipendenza:

   go mod edit -replace=private.example.com/foo=./private/private.example.com/foo
   

   Il file go.mod dovrebbe avere il seguente aspetto:

   File go.mod finale

   module private.example.com/myapp
   
   require private.example.com/foo v1.2.3
   
   replace private.example.com/foo => ./private/private.example.com/foo
   

   File go.mod originale

   module private.example.com/myapp
   
   require private.example.com/foo v1.2.3
   

4. Non modificare il modo in cui importi e utilizzi il pacchetto privato. L'istruzione import dovrebbe avere il seguente aspetto:

   import "private.example.com/foo"
   

5. Includi la dipendenza privata nel deployment dell'app:

   gcloud app deploy