App Bookshelf em .NET

O Bookshelf é um aplicativo de amostra da Web escrito em .NET que mostra como usar vários produtos do Google Cloud Platform (GCP), incluindo:

  • Ambiente flexível do App Engine
  • Cloud SQL
  • Cloud Datastore
  • Cloud Storage
  • Cloud Pub/Sub
  • Compute Engine

Neste tutorial, você vai explorar o aplicativo Bookshelf e ver como cada recurso do aplicativo é 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.
  • Saber como o app usa o Cloud Pub/Sub para enviar tarefas a um trabalhador em segundo plano.

Custos

Neste tutorial, há componentes do GCP passíveis de cobrança, como o Compute Engine.

Este tutorial tem várias etapas, e cada uma está documentada na própria página. Na página final, há instruções sobre como limpar 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 limpeza 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 a região em que o aplicativo do App Engine será armazenado e ative o faturamento. O Painel será aberto logo após a criação do projeto do GCP.

    2. Ativar Cloud Datastore, Cloud Pub/Sub, Cloud Storage JSON, Stackdriver Logging e Google+ APIs.

      Ativar a de 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]
    em que [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/getting-started-dotnet.git

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

Neste tutorial, partimos do princípio de que você tem o Visual Studio 2017 ou posterior instalado e que está familiarizado com o .NET Framework e a linguagem C#.

Como criar uma instância do Compute Engine

Use o Google Cloud Platform Marketplace para criar uma nova instância do Compute Engine que tenha o Windows Server 2016 R2, o Microsoft IIS, o ASP.NET e o SQL Express pré-instalados.

  1. No Console do GCP, acesse a página do GCP Marketplace ASP.NET Framework.

  2. Defina o nome da implantação como bookshelf-tutorial.

  3. Escolha uma zona do Compute Engine.

  4. Para implantar a instância, clique em Implantar.

Adicionar um usuário à instância do Compute Engine

Quando o processo de implantação terminar, adicione um usuário padrão do Windows à nova instância.

  1. No Console do GCP, acesse Instâncias da VM.

  2. Clique em bookshelf-tutorial.

  3. Na página Instância, clique em Definir senha do Windows.

  4. Na caixa de diálogo Definir nova senha do Windows, adicione seu nome de usuário e clique em Definir para criar a conta de usuário na instância.

  5. Anote a senha fornecida e feche a caixa de diálogo.

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.

Na parte sobre dados estruturados, você verá como o app de amostra armazena informações de livros em um banco de dados SQL ou NoSQL.

A página da Web do app exibe um formulário em que o usuário pode inserir o título, o autor, a descrição e a data de publicação de um livro. O app armazena em um banco de dados todas as informações referentes a cada livro inserido, para que possam ser recuperadas posteriormente para visualização ou edição. Nesta etapa do tutorial, você pode escolher entre três bancos de dados: Cloud SQL, Cloud Datastore ou SQL Server. Quando concluir esta etapa usando um dos bancos de dados, passe para a próxima etapa.

A seção do tutorial referente ao Cloud Storage demonstra como o app de amostra armazena dados binários no Cloud Storage. Na página da Web do app, o usuário pode especificar uma imagem de capa para cada livro. Então, o aplicativo as armazena em um intervalo do Cloud Storage.

Na parte do Cloud Pub/Sub, você verá como o app usa o Cloud Pub/Sub para enviar tarefas a um trabalhador em segundo plano. No trabalhador, as informações são coletadas da API Google Books e o livro é atualizado no banco de dados.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…