startup os

StartupOS

Exemples de pile Open Source de Google et de déploiement dans le cloud.

Les principales technologies de la pile sont :

• Angulaire
• Tampons de protocole
• gRPC
• Bazel

Expérience pratique

Essayez ces didacticiels Google Cloud Shell :

Outil de formatage de code multilingue construit avec Bazel :

Champ et énumération de renommage API rétrocompatibilité 1 : comment les anciennes données peuvent toujours être lues par la nouvelle version, même après avoir renommé :

Champ et énumération de renommage de l'API rétrocompatibilité 2 : comment les anciennes versions peuvent communiquer avec les nouvelles versions sans se casser :

À déterminer

Langues prises en charge

Protos, gRPC et Bazel sont polyglottes. Les exemples de ce référentiel sont principalement en Java et Typescript, mais de nombreux autres langages sont pris en charge :

• gRPC et Protocol Buffers sont pris en charge par Google en C++, Java (et Android Java), Python, Go, C#, Objective-C, PHP, Dart, Ruby et JavaScript (y compris Node.js).
• Bazel est pris en charge par Google en Java (y compris les versions Android), Objective-C (y compris les versions iOS), C++, Go, Dart, Rust, Sass et Scala.
• La communauté a ajouté la prise en charge de nombreuses autres langues. Consultez cette liste pour les tampons de protocole et gRPC, et celle-ci pour Bazel.

Meilleurs exemples

• De nombreux exemples de tampons de protocole.
• gRPC-Web : une bibliothèque client js exécutée dans le navigateur, connectée à un serveur gRPC via un proxy HTTP. Le serveur et le client utilisent des stubs générés automatiquement par gRPC pour gérer la communication.
• Exemple de microservices gRPC.
• Exemple Docker : création de conteneurs à l'aide de Bazel (aucun fichier docker requis !).
• Kubernetes : un fichier de configuration montrant comment exécuter un conteneur construit avec Bazel sur k8s.
• Exemple CI : utilisation de CircleCI pour exécuter CI (intégration continue) et tester toutes les cibles Bazel.
• Firebase : client Java pour stocker les tampons de protocole ici.
• Dagger : framework Java Dependency Injection ("Next gen Guice"), voir exemples ici.
• Flogger : enregistreur Java avec API fluide, voir exemples ici.
• Application Android : une application Android créée avec Bazel et intégrée à Firebase.

Outils

Il existe plusieurs outils utiles dans la section outils.

Comment utiliser StartupOS

Vous pouvez traiter StartupOS comme une « image de développeur » avec une configuration prédéfinie et des outils associés.

Vous pouvez soit :

• Clonez ce dépôt et faites-le évoluer vous-même.
• Traitez-le comme une dépendance à votre propre dépôt. Un exemple est ici : https://github.com/oferb/startup-os-example

Installation

Installez Bazel. C'est ça!

Construire et tester

• Tout construire : ./build.sh
• Exécutez tous les tests : ./test.sh

À propos des monorepos

Un monorepo est une approche de développement logiciel dans laquelle tout le code est stocké dans un seul référentiel. Certaines choses sont plus faciles à faire dans un monorepo, comme le partage d'un fichier proto entre le front-end et le backend, d'autres sont plus difficiles, comme le contrôle par dépôt sur les collaborateurs, les notifications par e-mail, l'historique des validations, etc. Nous travaillons sur un approche dans laquelle plusieurs dépôts peuvent agir comme un seul monorepo, tout en restant des dépôts distincts, en utilisant des outils multi-dépôts tels que la révision du code multi-dépôt.

Quelques bonnes lectures sur l'approche monorepo :

• trunkbaseddevelopment.com/monorepos
• Pourquoi Google stocke des milliards de lignes de code dans un seul référentiel

Plateformes

Bien que Bazel prenne en charge Linux, Mac et Windows, ce référentiel prend en charge Linux et Mac. Si vous utilisez Windows 10, vous pouvez utiliser le sous-système Windows pour Linux (WSL). Il vous offre un environnement Linux, sans la surcharge d'une machine virtuelle.

Installation du sous-système Windows pour Linux :

Veuillez suivre le guide. Remarque : vous devrez peut-être effectuer une mise à niveau de Windows. Si vous en avez besoin, il vous le demandera au début de l'installation.

Contribuer

Vous êtes invités à contribuer et, ce faisant, à apprendre ces technologies. Vous pouvez consulter la liste des problèmes ou les jalons du projet.