diff --git a/0-quickstart/CreateKeyPair2.png b/0-quickstart/CreateKeyPair2.png new file mode 100644 index 0000000000000000000000000000000000000000..281e73336f59f6acbf74411ccadafffaa805846e Binary files /dev/null and b/0-quickstart/CreateKeyPair2.png differ diff --git a/0-quickstart/CreateKeyPair3.png b/0-quickstart/CreateKeyPair3.png new file mode 100644 index 0000000000000000000000000000000000000000..c63005b57c5cd78755732d968998c634f7205645 Binary files /dev/null and b/0-quickstart/CreateKeyPair3.png differ diff --git a/0-quickstart/README.md b/0-quickstart/README.md index 5aa8422ffa510a2d9909eab2c4e9f1bbc9cacc68..8e151a192e07212b1e7a5df88a9cb61d53f75249 100644 --- a/0-quickstart/README.md +++ b/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."). - + > **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" +  + +2. Name your new key and hit "Create Key Pair" again. Try to avoid special characters if possible.  +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.  + +## 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" +  + +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. +  -> **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. +  -## 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. + diff --git a/0-quickstart/SecurityGroups1.png b/0-quickstart/SecurityGroups1.png new file mode 100644 index 0000000000000000000000000000000000000000..e4e12e08821a10d036f0f7c48bdc760253981383 Binary files /dev/null and b/0-quickstart/SecurityGroups1.png differ diff --git a/0-quickstart/SecurityGroups2.png b/0-quickstart/SecurityGroups2.png new file mode 100644 index 0000000000000000000000000000000000000000..09a69aab8a78a899f4ba6113030860ca92c1f4a0 Binary files /dev/null and b/0-quickstart/SecurityGroups2.png differ diff --git a/0-quickstart/SecurityGroups3.png b/0-quickstart/SecurityGroups3.png new file mode 100644 index 0000000000000000000000000000000000000000..906c18df426e3f7365d2f0a197010d4c1b0cff44 Binary files /dev/null and b/0-quickstart/SecurityGroups3.png differ