Puoi specificare le dipendenze per l'app Node.js dichiarandole nel file package.json
.
Ad esempio, se vuoi specificare Lodash come dipendenza, il file package.json
potrebbe avere il seguente aspetto:
{
"dependencies": {
"lodash": "^4.0.1"
}
}
Durante il deployment, il runtime Node.js
installa automaticamente
tutti i dependencies
dichiarati nel file package.json
. Per impostazione predefinita viene utilizzato il comando npm install
, ma sono supportati anche i gestori di pacchetti Yarn e Pnpm:
Yarn: se esiste un file
yarn.lock
, viene utilizzato il comandoyarn install --production
.Pnpm: se esiste un file
pnpm-lock.yaml
, viene utilizzato il comandopnpm install
.
Tieni presente che devi assicurarti che il file yarn.lock
o pnpm-lock.yaml
non sia specificato nella sezione skip_files
del file app.yaml
.
Per impostazione predefinita, App Engine memorizza nella cache le dipendenze recuperate per ridurre i tempi di build. Per installare una versione della dipendenza non memorizzata nella cache, utilizza il comando:
gcloud app deploy --no-cache
Supporto e limitazioni per il file package.json
nell'ambiente standard:
Con App Engine puoi utilizzare qualsiasi pacchetto Node.js compatibile con Linux, inclusi i pacchetti che richiedono estensioni (C) native.
Se il campo
engines
è specificato inpackage.json
, devi definire una versione Node.js compatibile.Tutte le dipendenze definite nel campo
devDependencies
vengono ignorate e non vengono installate per la tua app in App Engine.Lo script
start
deve essere leggero ed escludere i passaggi di build per ottenere le migliori prestazioni perché lo script viene eseguito ogni volta che viene creata una nuova istanza della tua applicazione.
Dipendenze private con Artifact Registry
Se la tua app utilizza un modulo npm privato, puoi utilizzare un repository di pacchetti Node.js di Artifact Registry per ospitare le dipendenze private. Quando esegui il deployment della tua app, il processo di compilazione genera automaticamente le credenziali di Artifact Registry per l'account di servizio Cloud Build, in modo da non dover generare ulteriori credenziali.
Per includere le dipendenze private, elenca il repository Artifact Registry e
configura le impostazioni per l'autenticazione con il registry nel file .npmrc
nella directory dell'app. Ad esempio:
@SCOPE:registry=https://REGION_ID-npm.pkg.dev/PROJECT_ID/REPOSITORY_NAME
//REGION_ID-npm.pkg.dev/PROJECT_ID/REPOSITORY_NAME:always-auth=true
Tieni presente che questo approccio funziona anche per il gestore di pacchetti Yarn v1.
Se utilizzi Yarn v2 o versioni successive, elenca il repository Artifact Registry e configura le impostazioni per l'autenticazione con il registry nel tuo file .yarnrc.yml
nella directory dell'app. Ad esempio:
npmScopes:
SCOPE:
npmRegistryServer: https://REGION_ID-npm.pkg.dev/PROJECT_ID/REPOSITORY_NAME
npmAlwaysAuth: true
In seguito, includi i tuoi pacchetti nel file package.json
. Ad esempio:
{
"dependencies": {
" @SCOPE/my-package": "^1.0.0"
}
}
Installazione di un framework web
Dovrai utilizzare un framework web per consentire alla tua app di gestire le richieste web. Puoi utilizzare qualsiasi framework web Node.js, tra cui:
Per utilizzare un framework web specifico, come Express.js, aggiungi il framework al file package.json
:
Con npm in uso:
npm install --save express
Usando il filato:
yarn add express
Con pnpm:
pnpm add express
Ad esempio, il file package.json
risultante potrebbe avere il seguente aspetto:
{
"dependencies": {
"lodash": "^4.0.1",
"express": "^4.16.2"
}
}
Installazione delle librerie client di Cloud
Le librerie client Cloud per Node.js sono il modo idiomatico in cui gli sviluppatori Node.js possono integrarsi con i servizi Google Cloud, come Firestore in modalità Datastore (Datastore) e Cloud Storage.
Per installare la libreria client Node.js per Cloud Storage:
Installa le librerie client di Cloud in locale utilizzando un gestore di pacchetti:
Per utilizzare
npm
, esegui:npm install --save @google-cloud/storage
Per utilizzare
yarn
, esegui:yarn add @google-cloud/storage
Per utilizzare
pnpm
, esegui:pnpm add @google-cloud/storage
Configurare l'autenticazione. Puoi configurare le librerie client di Cloud per Node.js in modo da gestire automaticamente l'autenticazione.
Utilizza il riferimento libreria client Node.js per Cloud Storage per implementare il supporto per il servizio Cloud Storage nella tua app.