Gitiles
Code Review Sign In
gerrit-dev.monogon.dev / monogon / 968d72095a54aabed1a59cccf3591c4f32a7b70a
commit968d72095a54aabed1a59cccf3591c4f32a7b70a[log] [tgz]
authorSerge Bazanski <serge@monogon.tech>Wed Feb 07 16:33:38 2024 +0100
committerSerge Bazanski <serge@monogon.tech>Mon Feb 19 10:08:55 2024 +0000
tree815d7df587bd967164a572d2aef21a769aa2474e
parent6a328e61aece941c0b91a97c8303c235ce80f596 [diff]
root: move Metropolis README contents to metropolis/README.md, document launch-cluster

Change-Id: I3555ce1d31e83e27239bcd8dde20bdc69deac35c
Reviewed-on: https://review.monogon.dev/c/monogon/+/2765
Tested-by: Jenkins CI
Reviewed-by: Leopold Schabel <leo@monogon.tech>
2 files changed
tree: 815d7df587bd967164a572d2aef21a769aa2474e
  1. .github/
  2. build/
  3. cloud/
  4. go/
  5. intellij/
  6. metropolis/
  7. net/
  8. third_party/
  9. tools/
  10. version/
  11. .bazelignore
  12. .bazelproject
  13. .bazelrc
  14. .bazelrc.sandboxroot
  15. .bazelversion
  16. .git-ignore-revs
  17. .gitignore
  18. BUILD.bazel
  19. CODING_STANDARDS.md
  20. go.mod
  21. go.sum
  22. LICENSE
  23. MODULE.bazel
  24. MODULE.bazel.lock
  25. README.md
  26. SETUP.md
  27. shell.nix
  28. WORKSPACE
README.md

Monogon Monorepo

This is the main repository containing the source code for the Monogon Platform.

This is pre-release software - take a look, and check back later!

Environment

Our build environment is self-contained and requires only minimal host dependencies:

  • A Linux machine or VM.
  • Bazelisk >= v1.15.0 (or a working Nix environment).
  • A reasonably recent kernel with user namespaces enabled.
  • Working KVM with access to /dev/kvm (if you want to run tests).

Our docs assume that Bazelisk is available as bazel on your PATH.

Refer to SETUP.md for detailed instructions.

Monogon OS

The source code lives in //metropolis (Metropolis is the codename of Monogon OS).

See the //metropolis/README.md for a developer quick start guide, or see the Monogon OS Handbook for user documentation.

Run a single node demo cluster

Build CLI and node image:

bazel build //metropolis/cli/dbg //:launch --config dbg

Launch an ephemeral test node:

bazel test //:launch --config dbg --test_output=streamed

Run a kubectl command while the test is running:

bazel-bin/metropolis/cli/dbg/dbg_/dbg kubectl describe node

Test suite

Run full test suite:

bazel test --config dbg //...