104 lines
4.5 KiB
Markdown
104 lines
4.5 KiB
Markdown
# Valkey Collection for Ansible
|
|
|
|
This is a work in progress. This package is unstable and may not work as
|
|
expected, or may not work at all. Use this package at your own risk.
|
|
|
|
## Code of Conduct
|
|
|
|
We follow the [Ansible Code of Conduct](https://docs.ansible.com/ansible/devel/community/code_of_conduct.html)
|
|
in all our interactions within this project.
|
|
|
|
If you encounter abusive behavior, please refer to the [policy violations](https://docs.ansible.com/ansible/devel/community/code_of_conduct.html#policy-violations)
|
|
section of the Code for information on how to raise a complaint.
|
|
|
|
## Contributing to this collection
|
|
|
|
We are actively accepting new contributors and all types of contributions are
|
|
very welcome.
|
|
|
|
Don't know how to start? Refer to the [Ansible community guide](https://docs.ansible.com/ansible/devel/community/index.html)!
|
|
|
|
Want to submit code changes? Take a look at the [Quick-start development guide](https://docs.ansible.com/ansible/devel/community/create_pr_quick_start.html).
|
|
|
|
We also use the following guidelines:
|
|
|
|
* [Collection review checklist](https://docs.ansible.com/ansible/devel/community/collection_contributors/collection_reviewing.html)
|
|
* [Ansible development guide](https://docs.ansible.com/ansible/devel/dev_guide/index.html)
|
|
* [Ansible collection development guide](https://docs.ansible.com/ansible/devel/dev_guide/developing_collections.html#contributing-to-collections)
|
|
|
|
## Tested with Ansible
|
|
|
|
<!-- List the versions of Ansible the collection has been tested with. Must match what is in galaxy.yml. -->
|
|
|
|
## External requirements
|
|
|
|
<!-- List any external resources the collection depends on, for example minimum versions of an OS, libraries, or utilities. Do not list other Ansible collections here. -->
|
|
|
|
## Included content
|
|
|
|
<!-- Galaxy now usually displays full module and plugin docs within the UI. If you don't use Galaxy for your collection, you may need to either describe your plugins etc here, or point to an external docsite to cover that information. -->
|
|
|
|
## Using this collection
|
|
|
|
<!--Include some quick examples that cover the most common use cases for your collection content. It can include the following examples of installation and upgrade (change NAMESPACE.COLLECTION_NAME correspondingly):-->
|
|
|
|
### Installing the Collection from Ansible Galaxy
|
|
|
|
Before using this collection, you need to install it with the Ansible Galaxy
|
|
command-line tool:
|
|
```bash
|
|
ansible-galaxy collection install witine.valkey
|
|
```
|
|
|
|
You can also include it in a `requirements.yml` file and install it with
|
|
`ansible-galaxy collection install -r requirements.yml`, using the format:
|
|
```yaml
|
|
---
|
|
collections:
|
|
- name: witine.valkey
|
|
```
|
|
|
|
Note that if you install the collection from Ansible Galaxy, it will not be
|
|
upgraded automatically when you upgrade the `ansible` package. To upgrade the
|
|
collection to the latest available version, run the following command:
|
|
```bash
|
|
ansible-galaxy collection install witine.valkey --upgrade
|
|
```
|
|
|
|
You can also install a specific version of the collection, for example, if you
|
|
need to downgrade when something is broken in the latest version (please report
|
|
an issue in this repository). Use the following syntax to install version
|
|
`0.1.0`:
|
|
|
|
```bash
|
|
ansible-galaxy collection install witine.valkey:==0.1.0
|
|
```
|
|
|
|
See [using Ansible collections](https://docs.ansible.com/ansible/devel/user_guide/collections_using.html)
|
|
for more details.
|
|
|
|
## Release notes
|
|
|
|
See the [changelog](https://github.com/ansible-collections/REPONAMEHERE/tree/main/CHANGELOG.rst).
|
|
|
|
## More information
|
|
|
|
- [Ansible user guide](https://docs.ansible.com/ansible/devel/user_guide/index.html)
|
|
- [Ansible developer guide](https://docs.ansible.com/ansible/devel/dev_guide/index.html)
|
|
- [Ansible collections requirements](https://docs.ansible.com/ansible/devel/community/collection_contributors/collection_requirements.html)
|
|
- [Ansible community Code of Conduct](https://docs.ansible.com/ansible/devel/community/code_of_conduct.html)
|
|
- [The Bullhorn (the Ansible contributor newsletter)](https://docs.ansible.com/ansible/devel/community/communication.html#the-bullhorn)
|
|
- [Important announcements for maintainers](https://github.com/ansible-collections/news-for-maintainers)
|
|
|
|
## Postcardware
|
|
|
|
You're free to use this package, but if it makes it to your production
|
|
environment, we'd really appreciate you sending us a postcard, mentioning which
|
|
of our package(s) you are using.
|
|
|
|
Our address is: Witine Limited, St John's Innovation Centre, Cowley Road,
|
|
Cambridge CB4 0WS, United Kingdom
|
|
|
|
## Licensing
|
|
|
|
This package is licensed under the [3-clause BSD License](LICENSE.md).
|