{"id":21357823,"url":"https://github.com/rcbops/docker-openstack-cli","last_synced_at":"2026-01-03T11:32:20.331Z","repository":{"id":142014185,"uuid":"96907569","full_name":"rcbops/docker-openstack-cli","owner":"rcbops","description":null,"archived":false,"fork":false,"pushed_at":"2019-01-24T10:50:00.000Z","size":15,"stargazers_count":2,"open_issues_count":1,"forks_count":7,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-01-22T18:30:52.622Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rcbops.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-07-11T15:18:49.000Z","updated_at":"2019-01-24T10:29:40.000Z","dependencies_parsed_at":"2023-07-07T07:32:35.993Z","dependency_job_id":null,"html_url":"https://github.com/rcbops/docker-openstack-cli","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rcbops%2Fdocker-openstack-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rcbops%2Fdocker-openstack-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rcbops%2Fdocker-openstack-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rcbops%2Fdocker-openstack-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rcbops","download_url":"https://codeload.github.com/rcbops/docker-openstack-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243830956,"owners_count":20354856,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-22T05:12:32.675Z","updated_at":"2026-01-03T11:32:20.301Z","avatar_url":"https://github.com/rcbops.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenStack CLI\n\nUse a Docker image for OpenStack client tooling! [![Docker Repository on Quay](https://quay.io/repository/rackspace/openstack-cli/status \"Docker Repository on Quay\")](https://quay.io/repository/rackspace/openstack-cli)\n\n## Quick start\n\nDownload the [openrc.sh file](https://docs.openstack.org/user-guide/common/cli-set-environment-variables-using-openstack-rc.html) from Horizon in your OpenStack Cloud.\n\n```bash\nsource openrc.sh\n\n# ${PWD} is mounted to allow for actions requiring host filesystem access.\n# See 'Tips' section below\ndocker run -it --rm --volume ${PWD}:/data --env-file \u003c(env | grep OS_) quay.io/rackspace/openstack-cli\n/ # openstack --version\n/ # openstack server list\n/ # openstack volume list\n```\n\n## Tips\n\n### Openstack Clusters with Self-Signed CA certs\n\nIf your cluster is using a self signed certificate for the API endpoints, you can provide that when you run the container:\n\n* `mkdir certs` in the root of this repo\n* `cp path/to/my/ca.crt certs/ca.crt`\n* `docker run -it --rm --volume ${PWD}:/data -e OS_CACERT=/data/certs/ca.crt --env-file \u003c(env | grep OS_) quay.io/rackspace/openstack-cli`\n\n### Accessing a host directory\n\nThe `/data` directory is exposed as a volume that can be mounted.  This is convenient for OpenStack\ncommands that might require reading/writing host filesystems.  It is important to remember that\ncommands such as `openstack image save` should ensure that the location where the image is saved is\nin the `/data` folder when using the `--rm` command line option.  Example:\n\n```bash\nsource openrc.sh\n\ndocker run -it --rm \\\n  --volume ${PWD}:/data \\\n  --env-file \u003c(env | grep OS_) \\\n  quay.io/rackspace/openstack-cli \\\n  openstack image save --file /data/test_image.img ${IMAGE_GUID}\n```\n\n### Run one-off commands\n\nRun individual commands easily by passing them as the command to run and overriding the default `/bin/sh` command.  For one-off commands, it's a good practice to remove the container with the `--rm` argument so that you don't collect a bunch of orphaned containers.\n\n```bash\nsource openrc.sh\n\ndocker run -it --rm \\\n  --volume ${PWD}:/data \\\n  --env-file \u003c(env | grep OS_) \\\n  quay.io/rackspace/openstack-cli \\\n  openstack volume list\n```\n\n### Simplify your typing with aliases\n\n```bash\nsource openrc.sh\n\n# Get into a shell to run openstack commands\nalias osc='docker run -it --rm --volume ${PWD}:/data --env-file \u003c(env | grep OS_) quay.io/rackspace/openstack-cli'\n\n# Make it look like you're running openstack locally\nalias openstack='osc openstack'\n```\n\n## Update the OpenStack CLI version\n\nSubmit a PR with an update to the version in the [Dockerfile](Dockerfile). Once the PR merges, the `master` tag images at [quay.io/rackspace/openstack-cli](https://quay.io/rackspace/openstack-cli) will automatically be updated to that version.\n\nTo also update the `latest` tag do the following:\n\n1. Go to the [tags page](https://quay.io/repository/rackspace/openstack-cli?tab=tags).\n1. Click the gear icon for the `master` tag.\n1. Choose Add New Tag.\n1. Enter `latest` and click Move Tag.\n\n## Inspired by\n\nhttps://github.com/jmcvea/docker-openstack-client\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frcbops%2Fdocker-openstack-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frcbops%2Fdocker-openstack-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frcbops%2Fdocker-openstack-cli/lists"}