If you wish to avoid using the dashboard and perform actions from the command line (particularly if you wish to script certain actions), you can instead use the OpenStack client.
Installation
Depending on your operating system, the OpenStack client should be available through the default repositories:
- Ubuntu: apt-get install openstack
- CentOS: yum install openstack
- macOS*: sudo pip install python-openstackclient
*Note: You may need to install missing packages. Homebrew (https://brew.sh/) a missing package manager for macOS can assist with this.
More information on the client can be found here: https://docs.openstack.org/developer/python-openstackclient/
Windows 10 Users - Ubuntu Bash Shell (WSL):
If you are running Windows 10, you can optionally install the Ubuntu Bash Shell (Currently Ubuntu 14.04) - See the MSDN page for details and installation instructions. Once installed, the following commands can be used to install the OpenStack CLI client:
# Install dependencies to install the OpenStack client sudo apt-get update sudo apt-get install -y python-pip sudo apt-get install -y build-essential sudo apt-get install -y python-dev libxslt1-dev libxml2-dev # Install the OpenStack client sudo pip install python-openstackclient
Credentials
While potentially you can input your user credentials on the command line every time you run openstack, the simpler (and more secure) option is to put your credentials into a file which you read from before using the CLI. First create a file in your home directory (usually called openrc) with the following settings:
export OS_NO_CACHE='true' export OS_TENANT_NAME=<project_name> export OS_PROJECT_NAME=<project_name> export OS_USERNAME=<user_name> export OS_PASSWORD=<password> export OS_AUTH_URL='https://nimbus.pawsey.org.au:5000/' export OS_IDENTITY_API_VERSION=3 export OS_DEFAULT_DOMAIN='default' export OS_USER_DOMAIN_NAME='Default' export OS_PROJECT_DOMAIN_NAME='Default' export OS_AUTH_STRATEGY='keystone' export OS_REGION_NAME='RegionOne' export CINDER_ENDPOINT_TYPE='internalURL' export GLANCE_ENDPOINT_TYPE='internalURL' export KEYSTONE_ENDPOINT_TYPE='internalURL' export NOVA_ENDPOINT_TYPE='internalURL' export NEUTRON_ENDPOINT_TYPE='internalURL' export OS_ENDPOINT_TYPE='internalURL' export MURANO_REPO_URL='http://storage.apps.openstack.org/' export MURANO_PACKAGES_SERVICE='glance'
Where:
- <project_name> is the name of the project you are assigned to within Nimbus
- <user_name> is the username you would normally log in to the dashboard with
- <password> is your password
Once created, you can load your credentials by running:
. ~/openrc