{"id":20238467,"url":"https://github.com/smallstep/ansible-collection-cli","last_synced_at":"2026-05-13T23:32:12.924Z","repository":{"id":233601062,"uuid":"670314895","full_name":"smallstep/ansible-collection-cli","owner":"smallstep","description":"An Ansible collection for installing step CLI","archived":false,"fork":false,"pushed_at":"2024-04-16T17:18:24.000Z","size":34,"stargazers_count":3,"open_issues_count":2,"forks_count":0,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-01-14T01:14:59.738Z","etag":null,"topics":["ansible","ansible-collection","ansible-playbook","ansible-role","smallstep","step-cli"],"latest_commit_sha":null,"homepage":"https://smallstep.com/cli/","language":null,"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/smallstep.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-24T19:16:21.000Z","updated_at":"2024-11-26T21:10:38.000Z","dependencies_parsed_at":null,"dependency_job_id":"5c7cb874-7c61-47e3-9297-b9af90a237db","html_url":"https://github.com/smallstep/ansible-collection-cli","commit_stats":null,"previous_names":["smallstep/ansible-collection-cli"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smallstep%2Fansible-collection-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smallstep%2Fansible-collection-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smallstep%2Fansible-collection-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smallstep%2Fansible-collection-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smallstep","download_url":"https://codeload.github.com/smallstep/ansible-collection-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241685558,"owners_count":20003102,"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":["ansible","ansible-collection","ansible-playbook","ansible-role","smallstep","step-cli"],"created_at":"2024-11-14T08:34:18.490Z","updated_at":"2025-10-25T02:39:41.510Z","avatar_url":"https://github.com/smallstep.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ansible Collection - smallstep.cli\n\nThis collection provides the `smallstep.cli.install` role which can be used to install the [step CLI](https://github.com/smallstep/cli) binary onto your servers. It uses the [smallstep.sigstore](https://github.com/smallstep/ansible-collection-sigstore) collection to verify the [Sigstore](https://sigstore.dev/) signatures which Smallstep uses to sign our software artifacts.\n\nThis collection currently supports:\n\n* Fedora (Current Releases)\n* Enterprise Linux (RHEL, CentOS Stream, Rocky Linux, Alma Linux, etc)\n* Ubuntu (Current Stable and LTS releases)\n* Debian (Current Releases)\n* Arch Linux\n\nWe have some basic support for using this collection on Windows but it is untested. Use it at your risk!\n\n## Requirements\n\n* `ansible-galaxy collection install smallstep.sigstore` on control node\n* `ansible-galaxy collection install ansible.windows` # Only needed for Windows installs (Untested!!)\n* Python 3.8 or greater on servers\n* `pip` installed on servers\n* `pip install sigstore` on servers\n\n## Role: smallstep.cli.install\n\n### Role variables\n\n```yaml\nsmallstep_cli_version: # (Optional) Format: v0.2.24.4. Default: latest version\nsmallstep_cli_install_path: # (Optional) Default: /usr/local/bin.\nsmallstep_cli_download_url: # (Optional) Default: https://dl.smallstep.com/gh-release/cli/gh-release-header\nsmallstep_cli_verify_signature: # (Optional) Default: True\n```\n\n### Example Playbook\n\n```yaml\n---\n- hosts: all\n  become: True\n\n  collections:\n    - smallstep.sigstore\n    - smallstep.cli\n\n  pre_tasks:\n    - name: Make sure the current version of pip is installed.\n      dnf:\n        name: python3-pip\n        state: latest\n\n  roles:\n    - role: smallstep.cli.install\n      vars:\n        smallstep_cli_version: v0.24.4\n        smallstep_cli_install_path: /usr/local/bin\n        smallstep_cli_download_url: https://dl.smallstep.com/gh-release/cli/gh-release-header\n        smallstep_cli_verify_signature: True\n```\n\n## Playbook: smallstep.cli.install_step_cli\n\nAssuming you have the following requirements: Python 3.8 or greater, `pip` and `pip install sigstore` installed on your on servers, you may easily run the collection playbook `smallstep.cli.install_step_cli` to install the most recent version of step CLI.\n\n### Install the most recent version of step CLI\n\n```bash\nansible-playbook smallstep.cli.install_step_cli -i ansible_inventory\n```\n\n### Install a specific version of step CLI to the path of your choice\n\n```bash\nansible-playbook smallstep.cli.install_step_cli -i ansible_inventory -e \"smallstep_cli_version=v0.24.4\" -e \"smallstep_cli_install_path=/usr/bin\"\n```\n\n## Local development\n\n### Setup Ansible Collections workspace\n\nIn your source code directory do the following:\n\n```bash\nmkdir ansible_collections\ncd ansible_collections\ngit git@github.com:smallstep/ansible-collection-cli.git smallstep/cli\ngit clone git@github.com:smallstep/ansible-collection-sigstore.git smallstep/sigstore\ngit clone git@github.com:ansible-collections/ansible.windows.git ansible/windows\ncd smallstep/cli\n```\n\nThen make your changes and then run the `ansible-test` commands in the Testing section.\n\n## Testing\n\n### ansible-test sanity\n\n```bash\nansible-test sanity --docker --skip-test validate-modules\n```\n\n### ansible-test integration\n\n```bash\nansible-test integration --docker\n```\n\n## Local install\n\n### Install the collection dependencies\n\n```bash\nansible-galaxy collection install git+https://github.com/smallstep/ansible-collection-sigstore.git\nansible-galaxy collection install ansible.windows # Only needed for Windows installs (Untested!!)\n```\n\n### Install the smallstep.cli collection\n\n```bash\nansible-galaxy collection build --output-path /tmp --force\nansible-galaxy collection install /tmp/smallstep-cli-0.0.1.tar.gz --force\n```\n\n## Local uninstall\n\n```bash\nrm -rf ~/.ansible/collections/ansible_collections/smallstep/cli/\n```\n\n## License\n\n[Apache License Version 2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\nCopyright 2023 Smallstep Labs Inc.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmallstep%2Fansible-collection-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmallstep%2Fansible-collection-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmallstep%2Fansible-collection-cli/lists"}