Especificar dependências

Especifica as dependências da sua app Node.js declarando-as no ficheiro package.json.

Por exemplo, se quiser especificar Lodash como uma dependência, o ficheiro package.json pode ter o seguinte aspeto:

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

Pode usar qualquer pacote Node.js compatível com Linux no ambiente flexível do App Engine, incluindo pacotes que requerem extensões nativas (C).

Durante a implementação, o tempo de execução do Node.js instala automaticamente todos os dependencies declarados no seu ficheiro package.json. Por predefinição, é usado o comando npm install. No entanto, os gestores de pacotes Yarn e Pnpm também são suportados:

  • Yarn: se existir um ficheiro yarn.lock, é usado o comando yarn install --production.

  • Pnpm: suportado apenas pelos tempos de execução do Node.js versão 18 e versão 20 (pré-visualização). Se existir um ficheiro pnpm-lock.yaml, é usado o comando pnpm install.

Tenha em atenção que tem de garantir que o ficheiro yarn.lock ou pnpm-lock.yaml não está especificado na secção skip_files do ficheiro app.yaml.

Instalar uma framework Web

Tem de usar uma framework Web para permitir que a sua app publique pedidos Web. Pode usar qualquer framework Web Node.js, incluindo o seguinte:

Para usar uma framework Web específica, como o Express.js, adicione a framework ao ficheiro package.json:

  • Usando o npm:

    npm install express
  • Usar fio:

    yarn add express
  • Usando o pnpm:

    pnpm add express

Por exemplo, o ficheiro package.json resultante pode ter o seguinte aspeto:

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

Instalar as bibliotecas de cliente da Google Cloud

As bibliotecas cliente da nuvem para Node.js são a forma idiomática de os programadores de Node.js se integrarem com Google Cloud serviços, como o Firestore no modo Datastore (Datastore) e o Cloud Storage.

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

  1. Instale as bibliotecas cliente da nuvem localmente através de um gestor de pacotes:

    • Para usar o npm, execute o seguinte comando:

      npm install @google-cloud/storage
    • Para usar o yarn, execute o seguinte comando:

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

      pnpm add @google-cloud/storage
  2. Configurar autenticação. Pode configurar as bibliotecas cliente da nuvem para Node.js de modo a processarem a autenticação automaticamente.

  3. Use a biblioteca cliente Node.js para o Cloud Storage como referência para implementar suporte para o serviço Cloud Storage na sua app.