===== CLOUD CLI ACCESS =====

== INSTALL ==
Pip is preferred. The general CS infrastructure is a good starting point. However, our experience has been that the software installs cleanly and is free from dependency problems.

Try: <code>python3 -m pip install --user python-openstackclient</code>

===== CONFIGURATION =====

Use the ''~/.config/openstack/clouds.yaml'' file to direct your client. 

=== Generate New Credentials ===

Instead of taking risks and storing your University credentials in the file, use the [[ https://overcloud.cs.uchicago.edu | Web Interface ]] to create an Application Credential. Click the menu on the left side, Identity→Application Credentials. On the right side of the top of the page, click "Create Application Credential". Complete the form and check the box for ''unrestricted access''. Save the ''clouds.yaml'' file in your configuration directory.

See the [[ cloud:recipe:coding | Python Examples Document ]] for detailed configuration recommendations.

==Cloud Name==
For convenience, export the cloud name to your environment. Otherwise, all commands must include the flag ''--os-cloud=openstack'':
<code>
export OS_CLOUD=openstack 
</code>

====== USAGE ======

For more tips and usage information, see the [[ cloud:annotated_example | Annotated Example Usage ]]