Application Go Bookshelf

L'application Bookshelf constitue un exemple d'application Web écrite en Go qui illustre comment utiliser différents produits Google Cloud Platform (GCP), en particulier :

  • Environnement flexible App Engine
  • Cloud SQL
  • Cloud Datastore
  • Cloud Storage
  • Cloud Pub/Sub
  • Instance

Ce tutoriel explore l'application Bookshelf et décrit la façon dont chaque fonctionnalité est mise en œuvre à l'aide de technologies et services familiers fournis par GCP.

Capture d'écran de l'application Bookshelf montrant les commandes et couvertures de livres

L'exemple d'application Bookshelf stocke une collection de livres. Toute personne ayant accès à l'application peut ajouter des livres à la liste. Dans cet exemple d'application, les utilisateurs peuvent :

  • consulter la liste des livres ;
  • ajouter des livres et en supprimer de la liste ;
  • modifier les détails des livres ;
  • importer des images de couverture pour les livres ;
  • se connecter à leur compte Google et consulter les livres qu'ils ont ajoutés à la liste.

Objectifs

  • Cloner ou télécharger l'exemple d'application
  • Créer l'application et l'exécuter sur votre ordinateur local
  • Déployer l'application sur App Engine
  • Explorer l'exemple de code
  • Découvrir comment l'application stocke les données structurées
  • Découvrir comment l'application stocke les données binaires dans Google Cloud Storage
  • Découvrir comment l'application authentifie les utilisateurs
  • Découvrir comment l'application crée des journaux d'événements visibles dans la console Google Cloud Platform
  • Découvrir comment l'application utilise Cloud Pub/Sub pour envoyer des tâches à un nœud de calcul en arrière-plan

Coûts

Ce tutoriel fait appel à des composants facturables de GCP, dont Compute Engine.

Ce tutoriel comporte plusieurs étapes, chacune d'elle étant documentée sur sa propre page. La dernière page du tutoriel comprend des instructions relatives au nettoyage des ressources. Ainsi, vous ne serez pas facturé pour les services GCP. Si vous décidez de ne pas suivre toutes les étapes du tutoriel, consultez les instructions de nettoyage de la dernière page.

Avant de commencer

  1. Configurez votre projet Google Cloud Platform dans la console GCP :
    1. Créez un nouveau projet GCP, créez une application App Engine, puis activez la facturation dans ce projet.
      Accéder à App Engine

      Lorsque vous y êtes invité, sélectionnez la région dans laquelle vous souhaitez localiser votre application App Engine, puis activez la facturation. Une fois votre projet GCP créé, le tableau de bord apparaît.

    2. Activez Cloud Datastore, Cloud Pub/Sub, Cloud Storage JSON, Stackdriver Logging, et Google+les API requises.

      Activer les API.

  2. Téléchargez, installez et initialisez le SDK Cloud :
    Télécharger le SDK Cloud
  3. Procurez-vous les identifiants locaux pour l'authentification avec les services GCP.
    gcloud auth application-default login
  4. Vérifiez que votre projet par défaut est correctement défini :
    gcloud config list
    Si l'ID de projet qui s'affiche ne correspond pas à celui que vous souhaitez utiliser pour ce tutoriel, définissez le projet :
    gcloud config set project [YOUR_PROJECT_ID]
    [YOUR_PROJECT_ID] est l'ID du projet que vous avez créé ou choisi d'utiliser pour ce tutoriel.
  5. Clonez l'exemple de dépôt.

    go get -u -d github.com/GoogleCloudPlatform/golang-samples/getting-started/bookshelf/app

Ce tutoriel part du principe que vous connaissez bien le langage de programmation Go et que vous avez installé Go.

Structure du tutoriel

Le tutoriel consacré à Bookshelf comporte plusieurs parties qui expliquent comment l'exemple d'application utilise divers services GCP.

La partie du tutoriel relative aux données structurées décrit la façon dont l'exemple d'application stocke les informations des livres dans une base de données SQL ou NoSQL.

La page Web de l'application affiche un formulaire permettant à l'utilisateur de saisir le titre, l'auteur, la description et la date de publication d'un livre. Pour chaque livre ajouté, l'application stocke ces informations dans une base de données, qui pourront ainsi être consultées ou modifiées par la suite. Dans cette section du tutoriel, vous avez le choix entre trois bases de données : Cloud SQL, Cloud Datastore et MongoDB. Après avoir terminé cette partie avec l'une des bases de données, vous pouvez passer à l'étape suivante.

La partie du tutoriel relative à Cloud Storage décrit la façon dont l'exemple d'application stocke les données binaires dans Cloud Storage. Sur la page Web de l'application, l'utilisateur peut spécifier une image de couverture pour chaque livre. L'application stocke les images de couverture dans un bucket Cloud Storage.

La partie du tutoriel relative aux autorisations décrit la façon dont l'application fournit un flux de connexion à l'utilisateur. Lorsqu'un utilisateur est connecté, tous les livres ajoutés lui sont associés. Les utilisateurs connectés voient à la fois les livres créés par des utilisateurs anonymes et leurs propres livres. Les autres utilisateurs ne peuvent pas voir les livres créés par un utilisateur connecté.

La partie du tutoriel relative à la journalisation décrit la façon dont l'application consigne les journaux visibles dans la console Google Cloud Platform. Les journaux de ce type peuvent offrir des informations de diagnostic pendant le développement de l'application.

La partie du tutoriel relative à Cloud Pub/Sub décrit comment l'application utilise Cloud Pub/Sub pour envoyer des tâches à un nœud de calcul en arrière-plan. Le nœud de calcul collecte des informations à partir de l'API Google Livres et met à jour les informations du livre dans la base de données.

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…