Skip to content
Snippets Groups Projects
README.md 4.22 KiB
Newer Older
Radim Janča's avatar
Radim Janča committed
# Quickstart

Quickstart aims on users, which want to spin virtual machine in cloud as fast an possible.  
Radim Janča's avatar
Radim Janča committed
To create and gain acces to virtual machine you need to:
Radim Janča's avatar
Radim Janča committed
* Login to MetaCloud
* Upload/create ssh keys
* Start the virtual machine
* Login to instance

## 1. Login to MetaCloud

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:
Adam Merka's avatar
Adam Merka committed
2. **Domain -** UCN
Adam Merka's avatar
Adam Merka committed
3. **User Name -** UČO[^1]@ucn.muni.cz
4. **Password -** your secondary password.
> 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. The first step is to create/import SSH keys.

Adam Merka's avatar
Adam Merka committed
1. To create a new SSH key, go to **Project > Compute > Key Pairs** and click the button "Create Key Pair"  
Adam Merka's avatar
Adam Merka committed
  ![](/0-quickstart/Create Key Pair.png)
  {% endreveal %}

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]

Adam Merka's avatar
Adam Merka committed
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)
3. Add another rule. This time choose "SSH" and leave the remaining fields unchanged.  
   {% reveal %}
   ![](/0-quickstart/SecurityGroups2.png)
   {% endreveal %}
## 4. Start a virtual machine
Adam Merka's avatar
Adam Merka committed
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.
Adam Merka's avatar
Adam Merka committed
3. From the drop-down menu, choose **"Image"** as a source and select an operating system that you desire to run on your instance.
Adam Merka's avatar
Adam Merka committed
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.
## 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**".
Adam Merka's avatar
Adam Merka committed
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
Radim Janča's avatar
Radim Janča committed

Adam Merka's avatar
Adam Merka committed
[^1]: University unique identification number
Radim Janča's avatar
Radim Janča committed

[^2]: Please note that you still need to have your SSH key present on your local machine.