From ae1dd10bb530d5ba46e53f04009c8172d4a7561f Mon Sep 17 00:00:00 2001 From: Chad Smith Date: Wed, 6 Nov 2019 23:16:37 +0000 Subject: github: new basic project readme See rendered content at https://github.com/blackboxsw/cloud-init/tree/github/readme --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 00000000..07347d98 --- /dev/null +++ b/README.md @@ -0,0 +1,59 @@ +# Cloud-init official mirror synced from https://launchpad.net/cloud-init + +[![Build Status](https://travis-ci.org/cloud-init/cloud-init.svg?branch=master)](https://travis-ci.org/cloud-init/cloud-init) [![Read the Docs](https://readthedocs.org/projects/cloudinit/badge/?version=latest&style=flat)](https://cloudinit.readthedocs.org) + +Cloud-init is the *industry standard* multi-distribution method for +cross-platform cloud instance initialization. It is supported across all +major public cloud providers, provisioning systems for private cloud +infrastructure, and bare-metal installations. + +Cloud instances are initialized from a disk image and instance data: + +- Cloud metadata +- User data (optional) +- Vendor data (optional) + +Cloud-init will identify the cloud it is running on during boot, read any +provided metadata from the cloud and initialize the system accordingly. This +may involve setting up the network and storage devices to configuring SSH +access key and many other aspects of a system. Later on the cloud-init will +also parse and process any optional user or vendor data that was passed to the +instance. + +## Getting involved +All contributions welcome! [Join us easily following our hacking guide](https://cloudinit.readthedocs.io/en/latest/topics/hacking.html) + +## Getting help + +Having trouble? We would like to help! + +- Ask a question in the [``#cloud-init`` IRC channel on Freenode](https://webchat.freenode.net/?channel=#cloud-init) +- Join and ask questions on the [cloud-init mailing list](https://launchpad.net/~cloud-init) +- Find a bug? [Report bugs on Launchpad](https://bugs.launchpad.net/cloud-init) + +## Recent cloud-init upstream releases +Upstream release version | Release date | +--- | --- | +19.4 | planned (2019-12-XX) | +[19.3](https://launchpad.net/cloud-init/+milestone/19.3) | 2019-11-05 | +[19.2](https://launchpad.net/cloud-init/+milestone/19.2) | 2019-07-17 | +[19.1](https://launchpad.net/cloud-init/+milestone/19.1) | 2019-05-10 | + + +## Cloud-init distribution and cloud support +Note: Each linux distribution and cloud tracks cloud-init upstream updates at +a different pace. If your distribution or cloud doesn't contain a recent +cloud-init, suggest or propose an upgrade with your distribution of choice. + +| Supported OSes | Supported Public Clouds | Supported Private Clouds | +| --- | --- | --- | +| Ubuntu
SLES/openSUSE
RHEL/CentOS
Fedora
Gentoo Linux
Debian
ArchLinux
FreeBSD












| Amazon Web Services
Microsoft Azure
Google Cloud Platform
Oracle Cloud Infrastructure
Softlayer
Rackspace Public Cloud
IBM Cloud
Digital Ocean
Bigstep
Hetzner
Joyent
CloudSigma
Alibaba Cloud
OVH
OpenNebula
Exoscale
Scaleway
CloudStack
AltCloud
SmartOS
| Bare metal installs
OpenStack
LXD
KVM
Metal-as-a-Service (MAAS)















| + + +## Daily Package Builds +We host daily [Ubuntu Daily PPAs](https://code.launchpad.net/~cloud-init-dev/+recipes) that build package for each Ubuntu series from tip of cloud-init. + +For CentOS 7/8 we publish to a couple of COPR build repos: + + * [**cloud-init-dev**: daily builds from cloud-init tip](https://copr.fedorainfracloud.org/coprs/g/cloud-init/cloud-init-dev/) + -- cgit v1.2.3