It's much more straight-forward for users to read a create server example that does everything necessary to create the server within the body of a single method. In this better example the user doesn't have to refer to other examples to learn how to create a server. Change-Id: Iad7eef7946e93deb735fddcfbe39bbc8b56f507b
2.2 KiB
Connect From Config
In order to work with an OpenStack cloud you first need to create a
~openstack.connection.Connection to it using your
credentials. A ~openstack.connection.Connection can be created in 3
ways, using the class itself (see connect), a file, or environment variables as
illustrated below. The SDK uses os-client-config
to handle the configuration.
Note
To get your credentials Download the OpenStack RC file.
Create Connection From A File
Default Location
To create a connection from a file you need a YAML file to contain the configuration.
../../contributors/clouds.yaml
To use a configuration file called clouds.yaml in one of
the default locations:
- Current Directory
- ~/.config/openstack
- /etc/openstack
call :py~openstack.connection.from_config with an object that
has the name of the cloud configuration to use.
../examples/connect.py
../examples/connect.py
Note
To enable logging, set debug=True in the
Opts object.
User Defined Location
To use a configuration file in a user defined location set the
environment variable OS_CLIENT_CONFIG_FILE to the absolute
path of a file.:
export OS_CLIENT_CONFIG_FILE=/path/to/my/config/my-clouds.yaml
and call :py~openstack.connection.from_config with an object that
has the name of the cloud configuration to use.
../examples/connect.py
../examples/connect.py
Note
To enable logging, set debug=True in the
Opts object.
Next
Now that you can create a connection, continue with the user_guides for an OpenStack
service.