{"id":26518886,"url":"https://github.com/cobaltcore-dev/openstack-nix","last_synced_at":"2025-03-21T10:16:09.632Z","repository":{"id":283289162,"uuid":"932000925","full_name":"cobaltcore-dev/openstack-nix","owner":"cobaltcore-dev","description":"A set of Nix packages and NixOS modules allowing the usage of OpenStack in NixOS.","archived":false,"fork":false,"pushed_at":"2025-03-19T13:27:23.000Z","size":141,"stargazers_count":7,"open_issues_count":2,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-19T13:39:44.583Z","etag":null,"topics":["cloud","nix","nixos","openstack","virtualization"],"latest_commit_sha":null,"homepage":null,"language":"Nix","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/cobaltcore-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2025-02-13T07:47:23.000Z","updated_at":"2025-03-18T19:55:09.000Z","dependencies_parsed_at":"2025-03-19T13:39:49.443Z","dependency_job_id":"287bfda9-770a-4573-87b6-6e531168b6a8","html_url":"https://github.com/cobaltcore-dev/openstack-nix","commit_stats":null,"previous_names":["cobaltcore-dev/openstack-nix"],"tags_count":0,"template":false,"template_full_name":"cobaltcore-dev/repository-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cobaltcore-dev%2Fopenstack-nix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cobaltcore-dev%2Fopenstack-nix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cobaltcore-dev%2Fopenstack-nix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cobaltcore-dev%2Fopenstack-nix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cobaltcore-dev","download_url":"https://codeload.github.com/cobaltcore-dev/openstack-nix/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244776353,"owners_count":20508507,"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","nix","nixos","openstack","virtualization"],"created_at":"2025-03-21T10:16:09.071Z","updated_at":"2025-03-21T10:16:09.616Z","avatar_url":"https://github.com/cobaltcore-dev.png","language":"Nix","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![REUSE status](https://api.reuse.software/badge/github.com/cobaltcore-dev/openstack-nix)](https://api.reuse.software/info/github.com/cobaltcore-dev/openstack-nix)\n\n# openstack-nix\n\nA set of Nix packages and NixOS modules allowing the usage of OpenStack in NixOS.\n\n## About this project\n\nThe repository contains the following things:\n\n* Nix package descriptions for OpenStack libraries and executables\n* NixOS modules starting the basic OpenStack services (Keystone, Glance, Placement, Neutron, Nova, ...)\n* NixOS modules mimicking the configuration for a [minimal OpenStack setup](https://docs.openstack.org/install-guide/openstack-services.html#minimal-deployment-for-2024-2-dalmatian) (e.g. create users and databases)\n* NixOS tests checking basic OpenStack functions (e.g. server creation and live migration)\n\n## Style Checks\n\nIn our repo, we use [pre-commit](https://pre-commit.com/) via\n[pre-commit-hooks.nix](https://github.com/cachix/pre-commit-hooks.nix)\nto enforce a consistent style.\n\nIf you use the `nix develop` environment, pre-commit will be\nautomatically configured for you and fix or flag any style issues when you\ncommit.\n\nWhen style changes are necessary on files that were not touched in the\ncommit, you can re-run the checks on all files using:\n\n```console\n$ pre-commit run --all-files\n```\n\nThis happens for example when the version of the style checking tool\nis updated or its configuration was changed.\n\nSingle checks can be skipped using the\n[`SKIP`](https://pre-commit.com/#temporarily-disabling-hooks)\nenvironment variable, if they are problematic. As an escape hatch, use\n`git commit --no-verify` to avoid running _any_ checks.\n\n## Usage\n\nThe `openstack-nix` repository exports everything via a nix flake. You can\nspecify it as a flake input in your project or directly build certain\nattributes.\n\n### OpenStack Nix packages\n\nThe OpenStack services require a number of dependencies that are exported via:\n\n```nix\nopenstack-nix.packages\n```\n\n### NixOS modules\n\nThe NixOS modules are exported via\n\n```nix\nopenstack-nix.nixosModules\n```\n\nThere are modules to setup the OpenStack controller, an OpenStack compute node\nand modules simplifying the creation of new NixOS tests.\n\n### NixOS tests\n\nThe NixOS tests are located under the `tests` attribute. To execute a NixOS test\ndo the following:\n\n```shell\nnix build .#tests.x86_64-linux.\u003ctest-name\u003e\n```\n\nIf you want an interactive session:\n\n```shell\nnix build .#tests.x86_64-linux.\u003ctest-name\u003e.driverInteractive\n./result/bin/nixos-test-driver\n```\n\n## Scope\n\nOpenStack is a very large and super actively maintained project. We are aware that we cannot keep track of all its development or offer every single configuration option via NixOS modules.\n\nTherefore, we restricted ourself to the following goals for this project:\n\n* Make it easy to use OpenStack in a sane and useful default configuration.\n* Allow the user to customize packages and configurations, but there are no\n  guarantees that things will work then.\n\n## Support, Feedback, Contributing\n\nThis project is open to feature requests/suggestions, bug reports etc. via [GitHub issues](https://github.com/cobaltcore-dev/openstack-nix/issues). Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our [Contribution Guidelines](CONTRIBUTING.md).\n\n## Security / Disclosure\nIf you find any bug that may be a security problem, please follow our instructions at [in our security policy](https://github.com/cobaltcore-dev/openstack-nix/security/policy) on how to report it. Please do not create GitHub issues for security-related doubts or problems.\n\n## Code of Conduct\n\nWe as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone. By participating in this project, you agree to abide by its [Code of Conduct](https://github.com/SAP/.github/blob/main/CODE_OF_CONDUCT.md) at all times.\n\n## Licensing\n\nCopyright 2025 SAP SE or an SAP affiliate company and openstack-nix contributors. Please see our [LICENSE](LICENSE) for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available [via the REUSE tool](https://api.reuse.software/info/github.com/cobaltcore-dev/openstack-nix).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcobaltcore-dev%2Fopenstack-nix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcobaltcore-dev%2Fopenstack-nix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcobaltcore-dev%2Fopenstack-nix/lists"}