README files for top-level, AWS and installation directories.

Author: ipspace

AWS/README.md

@@ -0,0 +1,18 @@
+# AWS provisioning and automation examples
+
+The subdirectories contain numerous AWS provisioning and automation examples. In all cases
+the end result is the same:
+
+* VPC with custom CIDR block;
+* One or more subnets within that VPC;
+* Internet gateway attached to the VPC
+* Custom route table with default route pointing to the Internet gateway
+* Security group(s) permitting SSH, HTTP and HTTPS access from any IP address
+* EC2 t2.micro instance running in the public subnet
+
+Examples use four different tools:
+
+* Ansible playbooks
+* Bash scripts
+* CloudFormation templates
+* Terraform configuration files

README.md

@@ -0,0 +1,16 @@
+# Networking in Public Clouds
+
+This repository contains provisioning and automation examples for
+[Networking in Public Cloud Deployments](https://www.ipspace.net/PubCloud/) online course,
+[Amazon Web Services Networking](https://www.ipspace.net/Amazon_Web_Services_Networking) and
+[Microsoft Azure Networking](https://www.ipspace.net/Microsoft_Azure_Networking) webinars.
+
+The subdirectories are organized as follows:
+
+* [AWS](AWS) - Amazon Web Services examples and scripts
+* [Azure](Azure) - Azure examples and scripts
+* [install](install) - installation scripts you can use to set up a Ubuntu VM development
+  environment.
+
+You can also use the [Vagrantfile](Vagrantfile) in the main directory to create a Vagrant-based
+Ubuntu VM on your computer.

install/README.md

@@ -0,0 +1,19 @@
+# Install Your Development Environment
+
+This directory contains installation scripts that will help you set up a
+Ubuntu-based development environment. You could use them together with
+**Vagrantfile** from the top-level directory to build a simple Vagrant-based
+setup.
+
+* **setup.sh** - sets the environment variables. Modify it to suit your requirements
+* **install.sh** - main installation scripts. Sets the environment variables using **setup.sh**
+  and calls other installation scripts
+
+Component installation scripts:
+
+* **system.sh** - installs system and Python utilities. Also installs AWS CLI if you plan to
+  work with AWS.
+* **ansible.sh** - installs Ansible and its dependencies, including libraries needed to
+  manage AWS or Azure with Ansible
+* **azure-cli.sh** - installs Azure CLI
+* **terraform.sh** - installs Terraform