Como especificar dependências

Especifique as dependências do aplicativo Node.js declarando-as no arquivo package.json.

Por exemplo, se você quiser especificar Lodash como uma dependência, seu arquivo package.json pode ser semelhante a:

{
  "dependencies": {
    "lodash": "^4.0.1"
  }
}

É possível usar qualquer pacote do Node.js compatível com o Linux com o ambiente flexível do App Engine, inclusive pacotes que exigem extensões nativas (C).

Durante a implantação, todas as dependencies declaradas no arquivo package.json são instaladas automaticamente pelo ambiente de execução do Node.js. Por padrão, o comando npm install é usado, mas os gerenciadores de pacotes Yarn e Pnpm também são compatíveis:

  • Yarn: se existir um arquivo yarn.lock, o comando yarn install --production será usado.

  • Pnpm: compatível apenas com os ambientes de execução do Node.js versão 18 e versão 20 (visualização). Se um arquivo pnpm-lock.yaml existir, o comando pnpm install será usado.

É preciso garantir que o arquivo yarn.lock ou pnpm-lock.yaml não esteja especificado na seção skip_files do arquivo app.yaml.

Como instalar um framework da Web

Você precisará usar uma biblioteca da Web para permitir que o aplicativo disponibilize solicitações da Web. Você pode usar qualquer biblioteca da Web do Node.js, incluindo estas:

Para usar um framework da Web específico, como o Express.js, adicione o framework ao arquivo package.json:

  • usando npm:

    npm install --save express
  • usando yarn:

    yarn add express
  • Usando o pnpm:

    pnpm add express

Por exemplo, o arquivo package.json resultante pode ser semelhante a:

{
  "dependencies": {
    "lodash": "^4.0.1",
    "express": "^4.16.2"
  }
}

Como instalar as bibliotecas de cliente do Cloud

As bibliotecas de cliente do Cloud para Node.js são a maneira idiomática para os desenvolvedores do Node.js se integrarem aos serviços do Google Cloud, como o Firestore no modo Datastore (Datastore) e o Cloud Storage.

Para instalar a biblioteca de cliente do Node.js para o Cloud Storage:

  1. Instale as bibliotecas de cliente do Cloud localmente usando um gerenciador de pacotes:

    • Para usar npm, execute:

      npm install --save @google-cloud/storage
    • Para usar yarn, execute:

      yarn add @google-cloud/storage
    • Para usar pnpm, execute:

      pnpm add @google-cloud/storage
  2. Configure a autenticação. É possível configurar as bibliotecas de cliente do Cloud para Node.js para processar a autenticação automaticamente.

  3. Use a referência da biblioteca de cliente do Node.js para Cloud Storage a fim de implementar o suporte ao serviço do Cloud Storage no aplicativo.