{"id":13551398,"url":"https://github.com/coreos/coreos-cloudinit","last_synced_at":"2025-04-03T01:32:36.431Z","repository":{"id":14702200,"uuid":"17422391","full_name":"coreos/coreos-cloudinit","owner":"coreos","description":"[DEPRECATED] - Simple configuration tool for Container Linux","archived":true,"fork":false,"pushed_at":"2019-02-18T02:01:34.000Z","size":2034,"stargazers_count":343,"open_issues_count":17,"forks_count":161,"subscribers_count":45,"default_branch":"master","last_synced_at":"2024-08-01T12:24:33.669Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":false,"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/coreos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-03-05T00:25:47.000Z","updated_at":"2024-05-23T13:07:57.000Z","dependencies_parsed_at":"2022-09-26T20:11:33.889Z","dependency_job_id":null,"html_url":"https://github.com/coreos/coreos-cloudinit","commit_stats":null,"previous_names":[],"tags_count":89,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coreos%2Fcoreos-cloudinit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coreos%2Fcoreos-cloudinit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coreos%2Fcoreos-cloudinit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coreos%2Fcoreos-cloudinit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coreos","download_url":"https://codeload.github.com/coreos/coreos-cloudinit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222905862,"owners_count":17055818,"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":[],"created_at":"2024-08-01T12:01:47.321Z","updated_at":"2024-11-03T21:32:13.298Z","avatar_url":"https://github.com/coreos.png","language":"Go","funding_links":[],"categories":["Go","others"],"sub_categories":[],"readme":"**NOTE**: This project has been superseded by [Ignition][ignition] and is no longer under active development. Please direct all development efforts to Ignition.\n\n[ignition]: https://github.com/coreos/ignition\n\n# coreos-cloudinit [![Build Status](https://travis-ci.org/coreos/coreos-cloudinit.png?branch=master)](https://travis-ci.org/coreos/coreos-cloudinit)\n\ncoreos-cloudinit enables a user to customize CoreOS machines by providing either a cloud-config document or an executable script through user-data.\n\n## Configuration with cloud-config\n\nA subset of the [official cloud-config spec][official-cloud-config] is implemented by coreos-cloudinit.\nAdditionally, several [CoreOS-specific options][custom-cloud-config] have been implemented to support interacting with unit files, bootstrapping etcd clusters, and more.\nAll supported cloud-config parameters are [documented here][all-cloud-config]. \n\n[official-cloud-config]: http://cloudinit.readthedocs.org/en/latest/topics/format.html#cloud-config-data\n[custom-cloud-config]: https://github.com/coreos/coreos-cloudinit/blob/master/Documentation/cloud-config.md#coreos-parameters\n[all-cloud-config]: https://github.com/coreos/coreos-cloudinit/tree/master/Documentation/cloud-config.md\n\nThe following is an example cloud-config document:\n\n```\n#cloud-config\n\ncoreos:\n    units:\n      - name: etcd.service\n        command: start\n\nusers:\n  - name: core\n    passwd: $1$allJZawX$00S5T756I5PGdQga5qhqv1\n\nwrite_files:\n  - path: /etc/resolv.conf\n    content: |\n        nameserver 192.0.2.2\n        nameserver 192.0.2.3\n```\n\n## Executing a Script\n\ncoreos-cloudinit supports executing user-data as a script instead of parsing it as a cloud-config document.\nMake sure the first line of your user-data is a shebang and coreos-cloudinit will attempt to execute it:\n\n```\n#!/bin/bash\n\necho 'Hello, world!'\n```\n\n## user-data Field Substitution\n\ncoreos-cloudinit will replace the following set of tokens in your user-data with system-generated values.\n\n| Token         | Description |\n| ------------- | ----------- |\n| $public_ipv4  | Public IPv4 address of machine |\n| $private_ipv4 | Private IPv4 address of machine |\n\nThese values are determined by CoreOS based on the given provider on which your machine is running.\nRead more about provider-specific functionality in the [CoreOS OEM documentation][oem-doc].\n\n[oem-doc]: https://coreos.com/docs/sdk-distributors/distributors/notes-for-distributors/\n\nFor example, submitting the following user-data...\n\n```\n#cloud-config\ncoreos:\n    etcd:\n        addr: $public_ipv4:4001\n        peer-addr: $private_ipv4:7001\n```\n\n...will result in this cloud-config document being executed:\n\n```\n#cloud-config\ncoreos:\n    etcd:\n        addr: 203.0.113.29:4001\n        peer-addr: 192.0.2.13:7001\n```\n\n## Bugs\n\nPlease use the [CoreOS issue tracker][bugs] to report all bugs, issues, and feature requests.\n\n[bugs]: https://github.com/coreos/bugs/issues/new?labels=component/cloud-init\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoreos%2Fcoreos-cloudinit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoreos%2Fcoreos-cloudinit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoreos%2Fcoreos-cloudinit/lists"}