Questa pagina è stata tradotta dall'API Cloud Translation.

Specifica delle dipendenze

Specifica le dipendenze per la tua 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 tutte le dependencies dichiarate nel file package.json. Per impostazione predefinita, viene utilizzato il comando npm install, ma sono supportati anche i gestori pacchetti Yarn e Pnpm:

Yarn: se esiste un file yarn.lock, viene utilizzato il comando yarn install --production.
Pnpm: se esiste un file pnpm-lock.yaml, viene utilizzato il comando pnpm 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 compilazione. Per installare una versione non memorizzata nella cache della dipendenza, utilizza il comando:

gcloud app deploy --no-cache

Supporto e limitazioni per il file package.json nell'ambiente standard:

Puoi utilizzare qualsiasi pacchetto Node.js compatibile con Linux con App Engine, inclusi i pacchetti che richiedono estensioni native (C).
Se il campo engines è specificato in package.json, devi definire una versione di Node.js compatibile.
Tutte le dipendenze definite nel campo devDependencies vengono ignorate e non vengono installate per la tua app in App Engine.
Per un rendimento ottimale, lo script start deve essere leggero ed escludere i passaggi di compilazione perché viene eseguito ogni volta che viene creata una nuova istanza dell'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. Durante il deployment dell'app, il processo di compilazione genera automaticamente le credenziali di Artifact Registry per l'account di servizio Cloud Build, quindi non è necessario generare credenziali aggiuntive. 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 dei pacchetti Yarn 1. Se utilizzi Yarn 2 o versioni successive, elenca il repository Artifact Registry e configura le impostazioni per l'autenticazione con il registry nel file .yarnrc.yml nella directory dell'app. Ad esempio:

npmScopes:
  SCOPE:
    npmRegistryServer: https://REGION_ID-npm.pkg.dev/PROJECT_ID/REPOSITORY_NAME
    npmAlwaysAuth: true

Successivamente, includi i 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 determinato framework web, ad esempio Express.js, aggiungilo al file package.json:

Utilizzando npm:
```
npm install --save express
```
Utilizzo di yarn:
```
yarn add express
```
Utilizzo di 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 Cloud

Le librerie client di Cloud per Node.js sono il modo idiomatico per gli sviluppatori Node.js di eseguire l'integrazione 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 Cloud localmente utilizzando un gestore dei 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 Cloud per Node.js in modo che gestiscono automaticamente l'autenticazione.
Utilizza la documentazione di riferimento della libreria client Node.js per Cloud Storage per implementare il supporto del servizio Cloud Storage nella tua app.