Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/coreos/ignition
First boot installer and configuration tool
https://github.com/coreos/ignition
Last synced: 5 days ago
JSON representation
First boot installer and configuration tool
- Host: GitHub
- URL: https://github.com/coreos/ignition
- Owner: coreos
- License: apache-2.0
- Created: 2015-03-28T03:52:33.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2024-10-21T19:16:35.000Z (18 days ago)
- Last Synced: 2024-10-21T21:12:57.905Z (18 days ago)
- Language: Go
- Homepage: https://coreos.github.io/ignition/
- Size: 21.9 MB
- Stars: 837
- Watchers: 41
- Forks: 247
- Open Issues: 117
-
Metadata Files:
- Readme: README.md
- Changelog: NEWS.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: code-of-conduct.md
- Support: docs/supported-platforms.md
Awesome Lists containing this project
- awesome-repositories - coreos/ignition - First boot installer and configuration tool (Go)
- awesome-starred - coreos/ignition - First boot installer and configuration tool (others)
README
# Ignition
Ignition is a utility created to manipulate disks during the initramfs. This includes partitioning disks, formatting partitions, writing files (regular files, systemd units, etc.), and configuring users. On first boot, Ignition reads its configuration from a source of truth (remote URL, network metadata service, hypervisor bridge, etc.) and applies the configuration.
## Usage
Odds are good that you don't want to invoke Ignition directly. In fact, it isn't even present in the root filesystem. Take a look at the [Getting Started Guide][getting started] for details on providing Ignition with a runtime configuration.
## Known users
- Fedora CoreOS
- Red Hat Enterprise Linux CoreOS
- Flatcar
- openSUSE MicroOS
- SUSE Linux Enterprise Micro
## Contact
- Mailing list: [[email protected]](https://lists.fedoraproject.org/archives/list/[email protected]/)
- IRC: #[fedora-coreos](ircs://irc.libera.chat:6697/#fedora-coreos) on Libera.Chat
- Reporting bugs: [issues][issues]
## Contributing
See [CONTRIBUTING](CONTRIBUTING.md) for details on submitting patches and the contribution workflow.
To help triage or fix bugs, see the current [Ignition issues](https://github.com/coreos/ignition/issues/).
## Config Validation
To validate a config for Ignition there are binaries for a cli tool called `ignition-validate` available [on the releases page][releases]. There is also an ignition-validate container: `quay.io/coreos/ignition-validate`.
Example:
```
# This example uses podman, but docker can be used too
podman run --pull=always --rm -i quay.io/coreos/ignition-validate:release - < myconfig.ign
```
[getting started]: docs/getting-started.md
[issues]: https://github.com/coreos/ignition/issues/new/choose
[releases]: https://github.com/coreos/ignition/releases