Skip to content
Snippets Groups Projects
README.md 7.21 KiB
Newer Older
# Using OpenStack's Web Interface

Tomas Stribula's avatar
Tomas Stribula committed
This introduction is intended for users that want to start a few virtual machine instances in the cloud or they want to adjust their project more carefully to their needs through the Graphical Interface of OpenStack.

The process is practically very similar to creating a virtual machine instance in [Quickstart](https://cloud.gitlab-pages.ics.muni.cz/documentation/0-quickstart/), you need to
* sign in via the MetaCentrum cloud web interface,
* create an *ssh* key pair or use an existing key pair,
* create virtual machine instances,
* create virtual private network,
* create virtual router,
* join virtual private network to internet through router interfaces,
* set up or update a security group,
* start a virtual machine instance,
* allocate floating IP address (add or remove IP address to/from virtual machine instance)
* log in to the running instance using *ssh* (secure shell),
* (optional) create new volume (add/remove volume to/from virtual machine instance).

## Sign In

The web interface is available at [https://cloud.muni.cz](https://cloud.muni.cz).

To sign in,
* select `ENIFRA CESNET`,
* click on `Sign In`,
Tomas Stribula's avatar
Tomas Stribula committed
{% reveal text="Show Screenshot" %}
  ![](/1-gui/sign_in1.png)
{% endreveal %}
Tomas Stribula's avatar
Tomas Stribula committed
* select your institution from the drop-down list (use the search box at the top as a filter),
Tomas Stribula's avatar
Tomas Stribula committed
{% reveal text="Show Screenshot" %}
  ![](/1-gui/sign_in2.png)
{% endreveal %}
Tomas Stribula's avatar
Tomas Stribula committed
* provide your institution-specific sign-in credentials,
Tomas Stribula's avatar
Tomas Stribula committed
{% reveal text="Show Screenshot" %}
  ![](/1-gui/sign_in3.png)
{% endreveal %}
Tomas Stribula's avatar
Tomas Stribula committed
* wait to be redirected back to our web interface.

## Create Key Pair

All virtual machine instances running in the cloud have to be accessed remotely. The most common way of accessing a virtual machine instance remotely is the secure shell - *ssh*. Using *ssh* requires a pair of cryptographic keys.

1. To create a new *ssh* key pair, go to **Project > Compute > Key Pairs** and click the button "Create Key Pair"
{% reveal text="Show Screenshot" %}
  ![](/0-quickstart/CreateKeyPair1.png)
{% endreveal %}
2. Name your new key and click on "Create Key Pair" again. Avoid using special characters, if possible.
{% reveal text="Show Screenshot" %}
  ![](/0-quickstart/CreateKeyPair2.png)
{% endreveal %}
3. You can see your newly created key pair and its fingerprint. We recommend you store the key in a safe location and back it up in case you accidentally delete it.
{% reveal text="Show Screenshot" %}
  ![](/0-quickstart/CreateKeyPair3.png)
{% endreveal %}

1. In **Project > Network > Network Topology** you can see the actual status of your networks. In the beginning there are only public networks visible, because you haven't created yet your network. You can do it by clicking on the button "Create Network". This network will serve as connection of your instances.
{% reveal text="Show Screenshot" %}
  ![](/1-gui/network1.png)
{% endreveal %}
Tomas Stribula's avatar
Tomas Stribula committed

2. Name the network, which will join your instances, and click "Next".
{% reveal text="Show Screenshot" %}
  ![](/1-gui/network2.png)
{% endreveal %}
3. In Subnet tab name your subnet and choose a range of valid IP addresses (e.g. 10.1.1.0/24 or whatever you wanti) in CIDR format. The gateway will be automatically added as default (in our example it would be 10.1.1.1). Click "Next".
{% reveal text="Show Screenshot" %}
  ![](/1-gui/network3.png)
{% endreveal %}
4. In Subnet Details tab in Allocation Pools you can choose what ranges will be served by DHCP server (what ranges will be automatically assigned if a machine will use DHCP server for joining a subnet). Use format in description (e.g. for range between 10.1.1.220 and 10.1.1.249 write: 10.1.1.220,10.1.1.249 - so limits separated by comma). You can leave default DNS servers. Click "Create".
{% reveal text="Show Screenshot" %}
  ![](/1-gui/network4.png)
{% endreveal %}

5. Now in **Project > Network > Network Topology** you should see the new network created by you.
{% reveal text="Show Screenshot" %}
  ![](/1-gui/network5.png)
{% endreveal %}
   Now you can continue by creating router.
Tomas Stribula's avatar
Tomas Stribula committed

## Create router

1. In **Project > Network > Network Topology** or in **Project > Network > Routers** push the button "Create Router". This router will serve as connection between your subnet and public network.
{% reveal text="Show Screenshot" %}
  ![](/1-gui/router1.png)
{% endreveal %}
Tomas Stribula's avatar
Tomas Stribula committed

2. Add router name, select External Network (public network, through which you will be connected to internet) and click "Create Router". The router should be created and joined to public network.
{% reveal text="Show Screenshot" %}
  ![](/1-gui/router2.png)
{% endreveal %}

3. In **Project > Network > Network Topology** the router should be now visible.
{% reveal text="Show Screenshot" %}
  ![](/1-gui/router3.png)
{% endreveal %}

4. Now you can go to **Project > Network > Network Topology** and create interface for connection to your subnet. Pointing over the router icon you will get to information window, where is a button "Add Interface". Click on it.
{% reveal text="Show Screenshot" %}
  ![](/1-gui/router4.png)
{% endreveal %}
5. In opened pop-up window choose the available subnet. Click "Submit".
{% reveal text="Show Screenshot" %}
  ![](/1-gui/router5.png)
{% endreveal %}
6. In **Project > Network > Network Topology** you can now see your network joined to public network.
{% reveal text="Show Screenshot" %}
  ![](/1-gui/router6.png)
{% endreveal %}
Tomas Stribula's avatar
Tomas Stribula committed
## Create virtual machine instances

The creation of virtual machine instances is very straight-forward:
Tomas Stribula's avatar
Tomas Stribula committed
1. In **Compute > Instances** push the button "Launch Instance"
Tomas Stribula's avatar
Tomas Stribula committed
{% reveal text="Show Screenshot" %}
![](/1-gui/create_VMI1.png)
{% endreveal %}

2. Choose Instance Name and Count of instances, how many you want to create. If you are creating more instances, the number in format '-X' will be added automatically to the Instance Name for each instance. 
{% reveal text="Show Screenshot" %}
![](/1-gui/create_VMI2.png)
{% endreveal %}

Then click on Next.

Tomas Stribula's avatar
Tomas Stribula committed
3. Choose the source of booting: you can boot your Instances from Image or a snapshot. Pick the desired image to boot from. 
Tomas Stribula's avatar
Tomas Stribula committed
According to the purpose of your project you can change default settings: 
* persistent image (instance will be available after shutdown) - default option Create New Volume: Yes, or don't.
Tomas Stribula's avatar
Tomas Stribula committed
You can choose to delete Volume with Instance Delete, too.

{% reveal text="Show Screenshot" %}
![](/1-gui/create_VMI3.png)
{% endreveal %}

4. Pick the flavour - size of Instances created: VCPUs, RAM, Total Disk (Root). There are a few possibilities to choose from. You can add [additional disk]() later.

{% reveal text="Show Screenshot" %}
![](/1-gui/create_VMI4.png)
{% endreveal %}

5. Next you need to put your Instances to network created earlier

You can jumped through Network Ports and Security Groups to Key Pair.

6. In Key Pair you need to add your earlier created public key. It will be added to authorized keys on instances and will allow you to ssh access to them from terminal/Putty or whatever you are using as ssh tool for connecting.

If you haven't created key pair yet, you can do it now or you can import existing public key from file on your computer.

7. Then you can click on Launch Instance. After a few minutes they will be ready for using.

Tomas Stribula's avatar
Tomas Stribula committed
## Compute

## Volume
> TODO