github: new basic project readme

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

1 files changed, 59 insertions, 0 deletions

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<br />SLES/openSUSE<br />RHEL/CentOS<br />Fedora<br />Gentoo Linux<br />Debian<br />ArchLinux<br />FreeBSD<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /> | Amazon Web Services<br />Microsoft Azure<br />Google Cloud Platform<br />Oracle Cloud Infrastructure<br />Softlayer<br />Rackspace Public Cloud<br />IBM Cloud<br />Digital Ocean<br />Bigstep<br />Hetzner<br />Joyent<br />CloudSigma<br />Alibaba Cloud<br />OVH<br />OpenNebula<br />Exoscale<br />Scaleway<br />CloudStack<br />AltCloud<br />SmartOS<br /> | Bare metal installs<br />OpenStack<br />LXD<br />KVM<br />Metal-as-a-Service (MAAS)<br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br /><br />|
+
+
+## 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/)
+