Develop, Deploy.

[![Tests](https://github.com/next-hat/nanocl/actions/workflows/tests.yml/badge.svg)](https://github.com/next-hat/nanocl/actions/workflows/tests.yml) [![Clippy](https://github.com/next-hat/nanocl/actions/workflows/clippy.yml/badge.svg)](https://github.com/next-hat/nanocl/actions/workflows/clippy.yml)

[![codecov](https://codecov.io/gh/next-hat/nanocl/branch/nightly/graph/badge.svg?token=4I60HOW6HM)](https://codecov.io/gh/next-hat/nanocl)

Test, Deploy, Scale, Monitor, Orchestrate

**Nanocl** is an open-source distributed system designed to revolutionize developers' workflows.
It aims to provide an easy solution for localhost development, addressing common issues like CORS and cookies when working with complex microservice architectures.
Nanocl also facilitates seamless deployment to production.
By empowering developers and DevOps professionals, Nanocl helps optimize workflows, enhance security, and reduce operational costs. **Join our *[discord][discord]* and help us shape the future of infrastructure management.** ## Latest news - [2024/11/01] [End to End TLS encryption and first step for network meshing](https://docs.next-hat.com/blog/nanocl-0.16) (release) - [2024/06/11] [Man page, Backup, Remove Orphans and more](https://docs.next-hat.com/blog/nanocl-0.15) (release) - [2024/06/01] [We are invited to the Merge Berlin 2024](https://www.linkedin.com/feed/update/urn:li:activity:7201921660289998850) (event) - [2024/05/07] [Context, SubState and more](https://docs.next-hat.com/blog/nanocl-0.14) (release) ## Installation To install **Nanocl** for your system, please refer to our online [installation guide][nanocl_install_guide]. ## Documentation To learn more about **Nanocl**, you can take a look at the following resources: - [Overview][nanocl_overview] - [Get Started][nanocl_get_started] - [CLI References][nanocl_cli_ref] - [DAEMON References][nanocl_daemon_ref] ## Usage **Nanocl** is designed to be easy to operate by mostly using **Statefiles**.
**Statefiles** are `yaml`, `toml` or `json` files that define the state you want.
There is an example used to deploy our [documentation][documentation]: ```yaml ApiVersion: v0.16 # See all options: # https://docs.next-hat.com/references/nanocl/objects/cargo Cargoes: - Name: doc Container: Image: ghcr.io/next-hat/documentation:0.16.0 # See all options: # https://docs.next-hat.com/references/nanocl/objects/resource Resources: - Name: docs.next-hat.com Kind: ncproxy.io/rule Data: Rules: - Domain: docs.next-hat.com Network: Public Locations: - Path: / Target: Key: doc.global.c Port: 80 ``` To apply a state you can do it easily bu running `nanocl state apply -s path|url`
You can also remove a state by calling `nanocl state rm -s path|url`
## Demo Below are live demos of **Nanocl** in action: ### Cargo and Resource

### Job

### Vm

## Architecture **Nanocl** is designed in a **micro services** architecture several component are required and they are running as **container** included the **Nanocl Daemon** itself. The following components will be installed during `nanocl install` and are required to ensure **Nanocl** functionality: - `nstore` to save our state - `ndaemon` as **REST API** to manage everything - `nmetrics` to monitor cpu, memory and network usage - `nproxy` proxy to redirect traffic to our **containers** and **virtual machines** (optional) - `ncproxy` to update proxy configuration based on the current state (optional) - `ndns` to manage the dns entries for the **containers** and **virtual machines** (optional) - `ncdns` to update dns entries based on the current state (optional) Simplified version of our architecture for a single node:

## Contributing Every contribution is very welcome. Bug reports, feature requests, and pull requests are the most common ways to contribute. You can also help us by improving the [documentation][documentation_repository]. Learn how to setup a development environment by reading the [contribution guide][contributing_guide]. Also don't hesitate to join the [discord][discord] if you have any question! ## Sponsors Sponsors are the ones who make this project possible. They help us to keep the project alive and to improve it. If you want to become a sponsor, you can do so by clicking on the sponsor button.
People that sponsor us will have their name or logo displayed here, and will have access to a special role on our discord server. **If you sponsor for more then 40$ you will be rewarded with a VPS server with nanocl pre-installed ready to use for 1 month.**
You can also help us by contributing to the project, by reporting bugs, by suggesting new features, or by improving the [documentation][documentation_repository]. **Or just give a star it's free and it helps us a lot! ⭐️** **Huge thanks to our sponsors**

_mamaicode

_xf10w

_Rembo1510

## Star History [![Star History Chart](https://api.star-history.com/svg?repos=next-hat/nanocl&type=Date)](https://star-history.com/#next-hat/nanocl&Date) [contributing_guide]: ./CONTRIBUTING.md [documentation]: https://docs.next-hat.com [nanocl_overview]: https://docs.next-hat.com/guides/nanocl/overview [nanocl_install_guide]: https://docs.next-hat.com/manuals/nanocl/install/overview [nanocl_get_started]: https://docs.next-hat.com/guides/nanocl/get-started/orientation-and-setup [nanocl_cli_ref]: https://docs.next-hat.com/references/nanocl/cli [nanocl_daemon_ref]: https://docs.next-hat.com/references/nanocl/daemon/overview [docker]: https://www.docker.com [discord]: https://discord.gg/WV4Aac8uZg [documentation_repository]: https://github.com/next-hat/documentation