cloud-init-dev team mailing list archive

[Chad Smith <chad.smith@xxxxxxxxxxxxx>]

Chad Smith has proposed merging ~chad.smith/cloud-init:github/readme into cloud-init:master.

Commit message:
github: new basic project readme

See rendered content at https://github.com/blackboxsw/cloud-init/tree/github/readme

Requested reviews:
  cloud-init Commiters (cloud-init-dev)

For more details, see:
https://code.launchpad.net/~chad.smith/cloud-init/+git/cloud-init/+merge/375194
-- 
Your team cloud-init Commiters is requested to review the proposed merge of ~chad.smith/cloud-init:github/readme into cloud-init:master.

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..04045e8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,76 @@
+# 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 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/+filebug)
+
+## 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 support
+Each linux distribution tracks cloud-init upstream updates at a different pace.
+
+The table below represents current and planned releases of cloud-init by each distribution.
+
+OS                  | Cloud-init version                                            |  Update schedule
+---                 | ---                                               | ---
+CentOS 8| 18.5.1 | 
+CentOS 7| 18.5.3 | 
+Debian stable| 18.3-6 | 
+Debian testing| 19.2-4 | 
+Debian unstable| 19.2-4 | 
+FreeBSD | [19.2](https://www.freshports.org/net/cloud-init/) | 
+Fedora 31| 17.1.11 | 
+Fedora 29| 17.1.7 | 
+openSUSE Tumbleweed | 19.2 |
+openSUSE Leap 15.1 | 19.1 |
+Oracle Linux 7 | 18.5.3 |
+Oracle Linux 6 | 0.7.5.6 |
+Ubuntu 20.04 (Focal)| 19.3-0 | Weekly
+Ubuntu 19.10 (Eoan)| [19.2-36-g059d049c-0ubuntu3](https://github.com/cloud-init/cloud-init/tree/ubuntu/19.2-36-g059d049c-0ubuntu3) | Quarterly
+Ubuntu 18.04 (Bionic)| [19.2-36-g059d049c-0ubuntu2~18.04.1](https://github.com/cloud-init/cloud-init/tree/ubuntu/19.2-36-g059d049c-0ubuntu2~18.04.1) | QuarterlyUbuntu 16.04 (Xenial)| [19.2-36-g059d049c- 0ubuntu2~16.04.1](https://github.com/cloud-init/cloud-init/tree/ubuntu/19.2-36-g059d049c-0ubuntu2~16.04.1) | Quarterly
+Ubuntu 14.04 (Trusty)|[0.7.5-0ubuntu1.23](https://github.com/cloud-init/cloud-init/tree/ubuntu/0.7.5-0ubuntu1.23) | None
+Ubuntu 12.04 (Precise)| [0.6.3-0ubuntu1.25](https://github.com/cloud-init/cloud-init/tree/ubuntu/0.6.3-0ubuntu1.25) | None
+
+## Alternative cloud-init package updates
+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/)
+ * [**el-testing**: gets updates only for upstream releases or any version that is published as a Stable Release Update to stable Ubuntu series](https://copr.fedorainfracloud.org/coprs/g/cloud-init/el-testing/)
+ * [**el-stable**: Provide newer/stable updates than those available in EPEL repos](https://copr.fedorainfracloud.org/coprs/g/cloud-init/el-stable/)
+