{"id":19677867,"url":"https://github.com/slntopp/nocloud","last_synced_at":"2025-04-29T03:31:13.559Z","repository":{"id":36956140,"uuid":"413586239","full_name":"slntopp/nocloud","owner":"slntopp","description":"Cloud-native Open-Source Cloud Management Framework","archived":false,"fork":false,"pushed_at":"2025-04-26T13:31:21.000Z","size":19123,"stargazers_count":29,"open_issues_count":11,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-26T14:33:10.060Z","etag":null,"topics":["cloud","cloud-native","docker","go","golang","ione","nocloud","opennebula"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/slntopp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-10-04T21:19:28.000Z","updated_at":"2025-04-25T09:29:51.000Z","dependencies_parsed_at":"2024-02-26T08:25:10.476Z","dependency_job_id":"9dad8f16-2333-4a09-9132-adbbde608377","html_url":"https://github.com/slntopp/nocloud","commit_stats":null,"previous_names":[],"tags_count":52,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slntopp%2Fnocloud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slntopp%2Fnocloud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slntopp%2Fnocloud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slntopp%2Fnocloud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slntopp","download_url":"https://codeload.github.com/slntopp/nocloud/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251426827,"owners_count":21587657,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud","cloud-native","docker","go","golang","ione","nocloud","opennebula"],"created_at":"2024-11-11T17:35:33.626Z","updated_at":"2025-04-29T03:31:08.549Z","avatar_url":"https://github.com/slntopp.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NoCloud\n\nCloud-native Open-Source Cloud Management Framework\n\n[![StaticCheck](https://github.com/slntopp/nocloud/actions/workflows/checks.yml/badge.svg)](https://github.com/slntopp/nocloud/actions/workflows/checks.yml)\n[![Containers](https://github.com/slntopp/nocloud/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/slntopp/nocloud/actions/workflows/ci.yml)\n[![CodeQL](https://github.com/slntopp/nocloud/actions/workflows/codeql-analysis.yml/badge.svg?branch=master)](https://github.com/slntopp/nocloud/actions/workflows/codeql-analysis.yml)\n![Codiga](https://api.codiga.io/project/30612/status/svg)\n\n| **Table of Contents** |                 |\n|-------------------------------|---------|\n| [Installation](#installation) |         |\n| Docker | [Local](#running-localy)       |\n| - | [Production](#running-in-production)|\n| [Drivers](#drivers)           |         |\n| [CLI](#nocloud-cli)           |         |\n| - | [Usage](#usage)                     |\n| CLI Installation | [Linux](#linux)      |\n| - | [macOS](#macos)                     |\n| - | [Windows](#windows)                 |\n| - | [From Source](#build-from-source)   |\n| [Building Protobuf](#building-proto) |  |\n-------------------------------------------\n\n## Installation\n\nNoCloud is Cloud-native, meaning it can run in any OCI environment such as Docker(Compose), K8s, etc.\n\n### Running Localy\n\nAdd this to your `/etc/hosts` file:\n\n```shell\n127.0.2.1       nocloud.local\n127.0.2.1       traefik.nocloud.local # Traefik dashboard\n127.0.2.1       rbmq.nocloud.local # RabbitMQ Manager UI\n127.0.2.1       api.nocloud.local # REST and gRPC API\n127.0.2.1       db.nocloud.local # ArangoDB UI\n```\n\nJust do `docker-compose up` in the repo root, and you're ready to go.\nRead through the `docker-compose.yml` to see configuration options.\n\nNow you can navigate to Admin UI at [`http://api.nocloud.local/admin`](http://api.nocloud.local/admin).\n\n\u003e [!NOTE]\nAll NoCloud containers have multiple Log Levels.  \nAdd `LOG_LEVEL` to environment to change log level  \n`LOG_LEVEL` variates from -1(debug) to 5(Fatal)  \nSee `zap` reference for that  \n\n### Running in Production\n\nSee [this doc](examples/nocloud_public/README.md) to learn how to deploy NoCloud in production\n\n## Drivers\n\nIn order to make NoCloud an actual Cloud orchestration platform, it needs drivers, which would help creating groups and instances.\n\n### How to Add driver\n\n1. Add your driver into cluster/compose\n2. Add your driver to `services-registry` and `sp-registry` into env variable `DRIVERS`\n3. Start\n\nSee and try [this sample compose with IONe driver](examples/nocloud_n_ione/docker-compose.yml)\n\n### List of supported drivers\n\nCurrently we have only [IONe](https://github.com/slntopp/nocloud-driver-ione) driver. More drivers planned and community help is always appreciated!\n\n## NoCloud CLI\n\n### Usage\n\nStart with `nocloud help` and `nocloud help login` ;)\n\n### Homebrew\n\nSee [macOS](#macos).\n\n### Snap\n\nJust run\n\n```shell\nsnap install nocloud\n```\n\nand see usage [usage](#usage)\n\n### Linux\n\n#### `.deb` (Debian, Ubuntu, etc.)\n\n1. Go to [CLI Releases](https://github.com/slntopp/nocloud-cli/releases)\n2. Get `.deb` package for your CPU arch (`arm64` or `x86_64`)\n3. `dpkg -i path/to/.deb`\n\nIf you're using some other arch, let us know, we'll add it to the build. Meanwhile - try [building from source](#build-from-source)\n\nThen see usage [usage](#usage)\n\n#### `.rpm` (RedHat, CentOS, Fedora, etc.)\n\n1. Go to [CLI Releases](https://github.com/slntopp/nocloud-cli/releases)\n2. Get `.rpm` package for your CPU arch (`arm64` or `x86_64`)\n3. `yum localinstall path/to/.rpm` or `dnf install path/to/.rpm`\n\nIf you're using some other arch, let us know, we'll add it to the build. Meanwhile - try [building from source](#build-from-source)\n\nThen see usage [usage](#usage)\n\n#### AUR (Arch Linux, Manjaro, etc.)\n\nIf you have `yaourt` or `yay` package must be found automatically by label `nocloud-bin`\n\nOtherwise,\n\n1. `git clone https://aur.archlinux.org/packages/nocloud-bin`\n2. `cd nocloud-bin`\n3. `makepkg -i`\n\nThen see usage [usage](#usage)\n\n#### Others\n\nIf you're using other package manager or have none, you can download prebuilt binary in `.tar.gz` archive for `arm64` or `x86_64`, unpack it and put `nocloud` binary to `/usr/bin` or your `$PATH/bin`.\n\nIf you're using some other arch, let us know, we'll add it to the build. Meanwhile - try [building from source](#build-from-source)\n\nThen see usage [usage](#usage)\n\n### macOS\n\nIf you're using [**Homebrew**](https://brew.sh):\n\n```shell\nbrew tap slntopp/nocloud\nbrew install nocloud\n```\n\nYou're good to go!\n\nThen see usage [usage](#usage)\n\nIf you don't have [**Homebrew**](https://brew.sh), consider using it ;), otherwise you can get prebuilt binary from [CLI Releases page](https://github.com/slntopp/nocloud-cli/releases) as an `.tar.gz` archive.\n\n```shell\n# if you have wget then\nwget https://github/slntopp/nocloud-cli/releases/#version/nocloud-version-darwin-arch.tar.gz\n# if you don't, just download it\ntar -xvzf #nocloud-version-darwin-arch.tar.gz\n# move binary to /usr/local/bin or alike\nmv #nocloud-version-darwin-arch/nocloud /usr/local/bin\n```\n\nYou're good to go!\n\n\u003e [!TIP]\n\u003e Then see usage [usage](#usage)\n\n### Windows\n\n1. Go to [CLI Releases](https://github.com/slntopp/nocloud-cli/releases)\n2. Get prebuilt binary from [CLI Releases page](https://github.com/slntopp/nocloud-cli/releases) as an `.zip` archive.\n3. Unpack it\n4. Put it somewhere in `$PATH`\n\nThen see usage [usage](#usage)\n\n### Build From Source\n\nSee [CLI repo](https://github.com/slntopp/nocloud-cli) for source and instructions.\n\n## Building Proto\n\nFor docs and scripts navigate to [Proto repo](https://github.com/slntopp/nocloud-proto).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslntopp%2Fnocloud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslntopp%2Fnocloud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslntopp%2Fnocloud/lists"}