Updated README guide with new pcluster flow

Signed-off-by: ddeidda <[email protected]>

Author: ddeidda

README.rst

@@ -19,7 +19,16 @@ You can build higher level workflows, such as a Genomics portal that automates t
 
 Quick Start
 -----------
-First, install the library:
+**IMPORTANT**: you will need an **Amazon EC2 Key Pair** to be able to complete the following steps.
+Please see the `Official AWS Guide <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html>`_.
+
+First, make sure you have installed the `AWS Command Line Interface <http://>`_:
+
+.. code-block:: sh
+
+    $ pip install awscli
+
+Then you can install AWS ParallelCluster:
 
 .. code-block:: sh
 
@@ -35,34 +44,59 @@ Next, configure your aws credentials and default region:
     Default region name [us-east-1]:
     Default output format [None]:
 
-Then, run pcluster configure:
+Then, run ``pcluster configure``. A list of valid options will be displayed for each
+configuration parameter. Type an option number and press ``Enter`` to select a specific option,
+or just press ``Enter`` to accept the default option.
 
 .. code-block:: ini
 
   $ pcluster configure
-  Cluster Template [default]:
-  Acceptable Values for AWS Region ID:
-      ap-south-1
-      ...
-      us-west-2
+  INFO: Configuration file /dir/conf_file will be written.
+  Press CTRL-C to interrupt the procedure.
+
+
+  Allowed values for AWS Region ID:
+  1. eu-north-1
+  ...
+  15. us-west-1
+  16. us-west-2
   AWS Region ID [us-east-1]:
-  VPC Name [myvpc]:
-  Acceptable Values for Key Name:
-    keypair1
-    keypair-test
-    production-key
-  Key Name []:
-  Acceptable Values for VPC ID:
-    vpc-1kd24879
-    vpc-blk4982d
-  VPC ID []:
-  Acceptable Values for Master Subnet ID:
-    subnet-9k284a6f
-    subnet-1k01g357
-    subnet-b921nv04
-  Master Subnet ID []:
-
-Now you can create your first cluster;
+  ...
+
+Be sure to select a region containing the EC2 key pair you wish to use. You can also import a public key using
+`these instructions <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#how-to-generate-your-own-key-and-import-it-to-aws>`_.
+
+During the process you will be asked to set up your networking environment. The wizard will offer you the choice of
+using an existing VPC or creating a new one on the fly.
+
+.. code-block:: ini
+
+  Automate VPC creation? (y/n) [n]:
+
+Enter '``n``' if you already have a VPC suitable for the cluster. Otherwise you can let ``pcluster configure``
+create a VPC for you. The same choice is given for the subnet: you can select a valid subnet ID for
+both the master and compute nodes, or you can let ``pcluster configure`` set up everything for you.
+The same choice is given for the subnet configuration: you can select a valid subnet ID for both
+the master and compute nodes, or you can let pcluster configure set up everything for you.
+In the latter case, just select the configuration you prefer.
+
+.. code-block:: ini
+
+  Automate Subnet creation? (y/n) [y]: y
+  Allowed values for Network Configuration:
+  1. Master in a public subnet and compute fleet in a private subnet
+  2. Master and compute fleet in the same public subnet
+
+
+At the end of the process a message like this one will be shown:
+
+.. code-block:: ini
+
+  Configuration file written to /dir/conf_file
+  You can edit your configuration file or simply run 'pcluster create -c /dir/conf_file cluster-name' to create your cluster
+
+
+Now you can create your first cluster:
 
 .. code-block:: sh