Skip to content

Getting started

This chapter will show you how to interact with the Infomaniak Openstack Public Cloud. This guide is intended for both beginners and advanced users.

Basically there are two main approachs, the easy one for occasional uses and the more advanced one :

  1. Using Horizon, a web interface. This first option is the simplest and the recommended way to go for beginners as it requires no prior setup and is more visual.

  2. Using Openstack command-line clients. For advanced users; allows you to interact in a more powerful way using Openstack using command line tools.

Prerequisite

In order to use the Infomaniak Public Cloud you first need to create a project in your Infomaniak manager and retrieve the associated credentials.

Using Horizon

Info

The OpenStack dashboard is called Horizon and features an extensive official documentation.

https://api.pub1.infomaniak.cloud/horizon/

Horizon login page

Tip

Even if you prefer to user Openstack CLI clients, Horizon can still be useful to have a visual overview of your resources usage.

Horizon interface overview

Using the Openstack CLI clients

The unified OpenStack client (openstack) is the recommended command line interface. Most of the examples in this guide will use this client. We recommend to use the most recent OpenStack client available to you. There are also versions available for standalone Mac, Windows and Linux machines.

To install the OpenStack tools on your own client machine you can follow one of this method :

Installation

Linux

Red Hat / Cent OS
$ sudo yum install python3-openstackclient
Debian 10 (Buster)

If you didn't have the buster-backports repository activated, to so:

$ echo "deb http://deb.debian.org/debian buster-backports main" | sudo tee /etc/apt/sources.list.d/buster-backports
$ sudo apt-get update

Add the Victoria backports repository for Buster and install all OpenStack clients:

$ sudo apt install extrepo
$ sudo extrepo enable openstack_victoria
$ sudo apt update
$ sudo apt install openstack-clients
Debian 11 (Bullseye)
$ sudo apt install openstack-clients
Ubuntu
$ sudo add-apt-repository cloud-archive:victoria
$ sudo apt update
$ sudo apt install python3-aodhclient python3-barbicanclient python3-cinderclient python3-cloudkittyclient python3-glanceclient python3-gnocchiclient python3-heatclient python3-keystoneclient python3-magnumclient python3-neutronclient python3-novaclient python3-octaviaclient python3-openstackclient python3-osc-placement python3-swiftclient

MacOS

brew

Info

If brew is not already installed yet you can fetch the one-liner installation from https://brew.sh/

Once you have brew installed you can install Openstack client just like any other package

brew install openstackclient

pip

pip install --upgrade pip wheel
pip install python-openstackclient

Info

In case you wish not to mess-up with your system libraries you may as well use a Python virtual env, see the documentation at https://docs.python.org/3/library/venv.html

Getting ready

Source the openRC file (you can download it from your manager panel).

source ${PATH-TO-YOUR-OPENRC}/openrc

Sample command you can issue to test you are ready.

openstack project list
+----------------------------------+-------------+
| ID                               | Name        |
+----------------------------------+-------------+
| d17cf39d24a44eab9b1307db04886e3c | PCP-WDPGE71 |
+----------------------------------+-------------+
Back to top