startup os

СтартапОС

Примеры стека Google с открытым исходным кодом и его развертывания в облаке.

Основные технологии в стеке:

• Угловой
• Буферы протоколов
• gRPC
• Базель

Практический опыт

Попробуйте эти руководства по Google Cloud Shell:

Многоязычный инструмент форматирования кода, созданный с помощью Bazel:

Обратная совместимость API переименования полей и перечислений 1: как старые данные могут быть прочитаны в новой версии даже после переименования:

Обратная совместимость API переименования полей и перечислений 2: как старые выпуски могут взаимодействовать с новыми выпусками без нарушений:

подлежит уточнению

Поддерживаемые языки

Protos, gRPC и Bazel — полиглоты. Примеры в этом репозитории в основном написаны на Java и Typescript, но есть поддержка многих других языков:

• gRPC и буферы протоколов поддерживаются Google в C++, Java (и Android Java), Python, Go, C#, Objective-C, PHP, Dart, Ruby и JavaScript (включая Node.js).
• Bazel поддерживается Google на Java (включая сборки Android), Objective-C (включая сборки iOS), C++, Go, Dart, Rust, Sass и Scala.
• Сообщество добавило поддержку многих других языков. См. этот список для буферов протоколов и gRPC, а этот — для Bazel.

Лучшие примеры

• Множество примеров протокольных буферов.
• gRPC-Web: клиентская библиотека js, работающая в браузере, подключенная к серверу gRPC через HTTP-прокси. И сервер, и клиент используют автоматически создаваемые заглушки gRPC для обработки связи.
• Пример микросервисов gRPC.
• Пример Docker: создание контейнеров с помощью Bazel (файл dockerfile не требуется!).
• Kubernetes: файл конфигурации, показывающий, как запустить контейнер, созданный с помощью Bazel, на k8s.
• Пример CI: использование CircleCI для запуска CI (непрерывной интеграции) и тестирования всех целей Bazel.
• Firebase: Java-клиент для хранения буферов протоколов здесь.
• Dagger: платформа внедрения зависимостей Java («Guice следующего поколения»), примеры см. здесь.
• Flogger: Java-регистратор с гибким API, примеры см. здесь.
• Приложение для Android: приложение для Android, созданное с помощью Bazel и интегрированное с Firebase.

Инструменты

В разделе инструментов есть несколько полезных инструментов.

Как использовать StartupOS

Вы можете рассматривать StartupOS как «образ разработчика» с предварительно созданной настройкой и соответствующими инструментами.

Вы можете:

• Клонируйте этот репозиторий и развивайте его самостоятельно.
• Рассматривайте это как зависимость от вашего собственного репо. Пример здесь: https://github.com/oferb/startup-os-example.

Установка

Установите Базель. Вот и все!

Сборка и тестирование

• Соберите все: ./build.sh
• Запустите все тесты: ./test.sh

О монорепозиториях

Монорепо — это подход к разработке программного обеспечения, при котором весь код хранится в одном репозитории. Некоторые вещи проще делать в монорепозитории, например совместное использование файла прототипа между интерфейсом и сервером, некоторые вещи сложнее, например контроль над соавторами для каждого репозитория, уведомления по электронной почте, историю коммитов и т. д. Мы работаем над подход, при котором несколько репозиториев могут действовать как один монорепозиторий, оставаясь при этом отдельными репозиториями, с использованием инструментов для нескольких репозиториев, таких как проверка кода для нескольких репозиториев.

Несколько хороших отзывов о подходе монорепо:

• Trunkbaseddevelopment.com/monorepos
• Почему Google хранит миллиарды строк кода в одном репозитории

Платформы

Хотя Bazel поддерживает Linux, Mac и Windows, этот репозиторий поддерживает Linux и Mac. Если вы используете Windows 10, вы можете использовать подсистему Windows для Linux (WSL). Это дает вам среду Linux без затрат на виртуальную машину.

Установка подсистемы Windows для Linux:

Пожалуйста, следуйте руководству. Примечание. Возможно, вам придется выполнить обновление Windows. Если он вам нужен, он запросит его в начале установки.

Содействие

Вы можете внести свой вклад и при этом изучить эти технологии. Вы можете просмотреть список проблем или основные этапы проекта.