App Bookshelf em Node.js

O Bookshelf é um exemplo de app da Web escrito em Node.js que mostra como usar vários produtos do Google Cloud Platform (GCP), incluindo estes:

  • Ambiente padrão do App Engine
  • Cloud SQL
  • Cloud Datastore
  • Cloud Storage
  • Cloud Pub/Sub

Neste tutorial, você vai explorar o app Bookshelf e ver como cada recurso do app é implementado usando tecnologias e serviços familiares fornecidos pelo GCP.

Captura de tela do app Bookshelf mostrando controles e capas de livros

No Bookshelf, há uma coleção de títulos de livros. Qualquer pessoa com acesso a ele pode adicionar livros à lista. O app de amostra oferece estes recursos:

  • Os usuários podem ver a lista de livros.
  • Os usuários podem adicionar e remover livros da lista.
  • Os usuários editam detalhes dos livros.
  • Os usuários podem fazer upload de imagens de capas dos livros.

Objetivos

  • Clonar ou fazer o download do app de amostra.
  • Criar o app e executá-lo na máquina local.
  • Implantar o aplicativo no App Engine.
  • Analisar o código de amostra.
  • Saber como o app armazena dados estruturados.
  • Descobrir como os dados binários são armazenados pelo app no Cloud Storage.

Custos

Neste tutorial, usamos componentes faturáveis do GCP.

Este tutorial tem várias etapas, e cada uma delas está documentada em uma página específica. Na página final, há instruções sobre como remover os recursos para que você não seja cobrado pelos serviços do GCP. Caso decida não concluir todas as etapas do tutorial, consulte as instruções de remoção na última página.

Antes de começar

  1. Use o Console do GCP para configurar o projeto do Google Cloud Platform:
    1. Crie um projeto do GCP e um aplicativo do App Engine. Depois, ative o faturamento nesse projeto.
      Acessar o App Engine

      Quando solicitado, selecione uma região para o aplicativo do App Engine e ative o faturamento. Assim que o projeto do GCP é criado, o Painel é aberto.

    2. Ative as APIs Cloud Datastore, Cloud Pub/Sub, Cloud Storage JSON e Stackdriver Logging.

      Ative as APIs

  2. Faça o download, instale e inicialize o SDK do Cloud
    Fazer o download do SDK do Cloud
  3. Adquira as credenciais locais para fazer a autenticação nos serviços do GCP.
    gcloud auth application-default login
  4. Verifique se o projeto padrão está correto.
    gcloud config list
    Se o código listado na saída não for do projeto que você pretendia usar para este tutorial, configure o projeto.
    gcloud config set project [YOUR_PROJECT_ID]
    [YOUR_PROJECT_ID] é o código do projeto que você criou ou escolheu usar neste tutorial.
  5. Clone o repositório de amostra.

    git clone https://github.com/GoogleCloudPlatform/nodejs-getting-started.git

    Outra opção é fazer o download da amostra como um arquivo zip e extraí-lo.

Neste tutorial, esperamos que você esteja familiarizado com a programação em Node.js e já tenha preparado o ambiente para o desenvolvimento.

Estrutura do tutorial

O tutorial do Bookshelf tem várias partes que demonstram como o app de amostra usa os diversos serviços do GCP.