Updates 0-quickstart/README.md

Auto commit by GitBook Editor

0-quickstart/README.md

@@ -10,7 +10,7 @@ To create and gain acces to virtual machine you need to:
 
 ## 1. Login to MetaCloud
 
-One of the access options is the web interface that is available at [https://cloud.muni.cz](https://cloud.muni.cz). We recommend using the English version of the interface. The Czech translation of individual terms is not yet sufficiently experienced and their use may complicate communication with technical support. Use the following credentials to log in:
+1. One of the access options is the web interface that is available at [https://cloud.muni.cz](https://cloud.muni.cz). We recommend using the English version of the interface. The Czech translation of individual terms is not yet sufficiently experienced and their use may complicate communication with technical support. Use the following credentials to log in:
 
 * **Domain** **-** UCN
 * **User Name - **UČO[^1]@ucn.muni.cz
@@ -18,23 +18,58 @@ One of the access options is the web interface that is available at [https://clo
 
 > Please note that you need to access OpenStack from within the internal university network. You can either use the two available networks  - [eduroam and MUNI](https://it.muni.cz/en/services/wireless-wi-fi-connection "How to connect to Masaryk University network") or setup a [VPN access](https://it.muni.cz/en/services/vpn "How to setup a VPN access.").
 
-![](/0-quickstart/Create Key Pair.png)
+
 
 > **TODO** add login info and screenshots
 
 ## 2. Import/create SSH keys
 
-To create a first instance accessible from the network you typically need to go through a few one-time steps that are not required later on. These steps include primarily the SSH keys import and setup firewall rules setup. These rules are in the OpenStack context called Security Groups.
+To create a first instance accessible from the network you typically need to go through a few one-time steps that are not required later on. The first step is to create/import SSH keys.
+
+1. To create a new SSH key, go to **Project > Compute > Key Pairs **and clock the button "Create Key Pair"
+   ![](/0-quickstart/Create Key Pair.png)
+
+2. Name your new key and hit "Create Key Pair" again. Try to avoid special characters if possible. ![](/0-quickstart/CreateKeyPair2.png)
+3. You can see your newly created key pair and its fingerprint. Your browser will automatically save your key pair in your designated download location. We recommend you save it in a safe location and back it up andin case you accidentally delete it. ![](/0-quickstart/CreateKeyPair3.png)
+
+## 3. Set-up Security Groups
+
+All network traffic is blocked in OpenStack by default. You need to explicitly grant access to individual services by utilising Security Groups. This is similar to setting up firewall rules on your router or server. If setup correctly, you can access your virtual machine via SSH connection from your terminal.[^2]
+
+1. Go to **Project >  Networks > Security Groups **You can see a default security group. You can either create a new one or edit the default by hitting "Manage Rules"
+   ![](/0-quickstart/SecurityGroups1.png)
+
+2. Next you need to add two new rules to be able to connect to your new instance. Hit the button "Add rule", give it a name and choose "ALL ICMP". Leave the rest of the fields unchanged.
+   ![](/0-quickstart/SecurityGroups3.png)
 
-> **TODO** add images and steps how to create/import ssh keys
+3. Add another rule. This time choose "SSH" and leave the remaining fields unchanged.
+   ![](/0-quickstart/SecurityGroups2.png)
 
-## 3. Start a virtual machine
+## 4. Start a virtual machine
 
-> **TODO** add images and steps how to create virtual machine through quickstart GUI
+1. To spin up a new virtual machine, navigate to **Project > Compute > Instances** and hit the button "**Launch Instance**"
+2. Choose a name for your virtual machine.
+3. From the drop-down menu, choose **"Image" ** as a source and select an operating system that you desire to run on your instance.
+4. Choose a suitable configuration of RAM/CPUS/Disk space, also known as a Flavor. 
+5. Add a virtual network for your instance.
+6. You can leave the rest of the fields unchanged.
 
-## Login to a virtual machine
+
+
+## 5. Assign a public IP address
+
+To access your machine from the internet, you need to allocate a new public IP address to your project. Once the IP is allocated, you canthen assign it to a specific instance.  
+
+1. In the left menu, navigate to **Project** > **Network >  Floating IPs** and hit the button "**Allocate IP To Project**".
+2. Select "public-float-21" and hit the button "**Allocate IP**".
+3. The last step is to assign the IP to your selected instance. Find the instance you want and hit the "Associate Floating IP" in the last section of the row titled "**Actions**". 
+4. Finally simply select the allocated IP and you're done.
+
+## 6. Login to a virtual machine
 
 > **TODO** add steps how to lohin to VM
 
 [^1]: University unique identification number 
 
+[^2]: Please note that you still need to have your SSH key present on your local machine.
+