Skip to content

Getting Started with Minicloud

Igortorrente edited this page Apr 23, 2019 · 8 revisions

In this tutorial, you'll learn all the basic steps to successfully create and login into a virtual machine in your Minicloud account.

0. Overview

The first visible screen of our dashboard is the Overview. It shows all the relevant information about our project. The Instances tab shows our project's virtual machines. Images tab shows the available images to be used and Access & Security has project's security groups, public keys and firewall rules. Feel free to explore the remaining tabs.

1. Setting up Access & Security

The first thing we have to do is adding our public key to our project. That way, when a virtual machine is created, our public key will be automatically added to it's authorized keys and we'll be able to log in. It's a very simple process. In Access & Security tab, click on Key Pairs. You'll have two options: Import a key pair or create one.

1.1. Creating a Key Pair

Clicking on "Create Key Pair" will pop the screen below:

After typing a good name for your public key (easily identifiable), it will be downloaded to your machine in *.pem format. Remember to move it to a place easy to remember. By default, all public keys are stored at ~/.ssh.

1.2. Importing an Existing Key Pair

If you choose to import an existing public key, you have to copy the contents of your *.pub key to the Public Key field.

Since is not possible to select multiple keys for a VM, you can add as many keys as you want in this field, and all of them will be valid when trying to login later.

2. Creating an Instance

Go to Compute and click on Images tab. Pick an image by clicking on its respective Launch button. In Count you can specify the number of instances you want to create. In this example, we'll create one.

In Flavor you can specify which kind of machine you want:

Select which operational system you want, we will choose Ubuntu 18.04.

In Key Pair tab we select which key pair will have access to the instance we're creating. After selecting your key pair, go to Networking tab.

Now drop to Networks box all networks that you want your instance to be part of. Since we've created only one network, it'll be selected automatically.

The rest of the tabs are optional.

3. Adding ssh rule

Go to Network, Security Groups and then Manage Rules.

Click on Add Rule.

Select Custom TCP Rule, and then SSH.

Now click on Add.

4. Accessing our virtual machine

The associated IP address will be shown.

To access the virtual machine via SSH, if the associated IP is 10.8.QW.XYZ, we'll use the port QWXYZ.

After associating an IP, wait 5 minutes before connecting via SSH

So, in the above example, we would connect with:

ssh ubuntu@minicloud.parqtec.unicamp.br -p 40043 -i your-key.pem

For other OSs, change the username accordingly:

Image(s) Command
CentOS ssh centos@minicloud.parqtec.unicamp.br -p QWXYZ -i your-key.pem
Debian ssh debian@minicloud.parqtec.unicamp.br -p QWXYZ -i your-key.pem
Fedora ssh fedora@minicloud.parqtec.unicamp.br -p QWXYZ -i your-key.pem
openSUSE ssh opensuse@minicloud.parqtec.unicamp.br -p QWXYZ -i your-key.pem
Ubuntu ssh ubuntu@minicloud.parqtec.unicamp.br -p QWXYZ -i your-key.pem
You can’t perform that action at this time.