Skip to content

Latest commit

 

History

History
151 lines (92 loc) · 3.57 KB

index.rst

File metadata and controls

151 lines (92 loc) · 3.57 KB
Raw

Cloud Workshops on OpenStack @OVHcloud

This website hosts a collection of workshops to learn how to use OpenStack on OVH Public Cloud (although it can be adapted easily to different cloud provider using OpenStack).

Note

Before beginning the workshops, the following elements should have been communicated to you:

  • the address of the lab server
  • your username and password for the lab

Connect to the container

With this information you can connect to the lab server at the address:

https://{WORKSHOP_IDE_SERVER}/

You are now logged into your personal container.

Open Terminal

A good portion of the work done during these workshops will be done through the terminal. To open it:

  • Click Terminal
  • Then New Terminal

Load the credentials

Load the credentials contained in the openrc file to access your cloud project:

source openrc

You have now loaded the credentials enabling you to use OpenStack and complete the workshops.

Warning

If, during the workshop, you see this message:

Missing value auth-url required for auth plugin password

It probably means you forgot to load your credentials.

Conventions

Throughout the workshop you will encounter blocks of code instructing you to execute certain commands.

Please pay attention to the prompt (the start of the line):

  • The lines starting with a # are comments:

    # This is a comment, do not execute this

  • If there is no prompt at the start of the line or just a single $: you must run this command from the lab server directly

    # This command is to be run from the lab server:
echo "This is a test"

# This one two, without the leading `$`
$ echo "This is a test"

  • If there is a prompt (in the form of user@host:~$): you must run this command from the indicated instance

    # This command is to be run from the vm01 instance:
debian@vm01:~$ echo "Hello from vm01"

# This command is to be run from the vm02 instance:
debian@vm02:~$ echo "Hello from vm02"

OpenStack command line interface

OpenStack is a collection of projects providing an API to manage cloud infrastructure. Each project has its own API but the community maintains a common command line tool able to manage any part of the API: openstack.

The way it works is pretty consistent across projects and it is generally used in this way:

openstack {resource} {action} [options]

Here are some examples which should help you see the pattern:

# Create a new instance (server)
openstack server create --flavor=... --key-name=... --image=... NAME

# Delete a volume
openstack volume delete NAME
# or
openstack volume delete ID

# List networks
openstack network list

# Show the details of a specific instance
openstack server show NAME
# or
openstack server show ID

# Modify the properties of a specific object container
openstack container set --property ...=... ID

You can discover what actions are available for each resource using:

openstack {resource} --help

Then you have help on the actions like so:

openstack {resource} {action} --help

Let's start

You are now ready to complete the workshop:

.. toctree::
    :maxdepth: 1

    index
    day1/index
    day2/index
    day3/index