Prepare the D&D collection for its first release
This commit is contained in:
30
README.md
30
README.md
@@ -4,16 +4,34 @@ An Ansible collection for installing and configuring the D&D
|
|||||||
transcript-processing pipeline on Ubuntu 26.04. The assembled pipeline role is
|
transcript-processing pipeline on Ubuntu 26.04. The assembled pipeline role is
|
||||||
available as `rakestraw.dnd.pipeline` and supports Ansible Core 2.18 or newer.
|
available as `rakestraw.dnd.pipeline` and supports Ansible Core 2.18 or newer.
|
||||||
|
|
||||||
## Install from source
|
Release `0.1.0` contains the reviewed `rakestraw.dnd_pipeline` `v0.1.0`
|
||||||
|
snapshot and pins the Seriatim, Audita, Notarius, Scriptorium, and Narratio
|
||||||
|
roles to their respective `v0.1.0` releases.
|
||||||
|
|
||||||
Bootstrap the collection's exact standalone-role and collection dependencies:
|
## Install release 0.1.0
|
||||||
|
|
||||||
|
Download the tagged compatibility manifest and install its exact standalone
|
||||||
|
role and collection dependencies:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
|
curl -fLO \
|
||||||
|
https://gitea.maximumdirect.net/eric/ansible-collection-dnd/raw/tag/v0.1.0/requirements.yml
|
||||||
ansible-galaxy install -r requirements.yml
|
ansible-galaxy install -r requirements.yml
|
||||||
```
|
```
|
||||||
|
|
||||||
Build the collection into a temporary directory, then install the artifact
|
Then install the published collection artifact without resolving dependencies
|
||||||
without resolving dependencies a second time:
|
a second time:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
ansible-galaxy collection install \
|
||||||
|
https://gitea.maximumdirect.net/eric/ansible-collection-dnd/releases/download/v0.1.0/rakestraw-dnd-0.1.0.tar.gz \
|
||||||
|
--no-deps
|
||||||
|
```
|
||||||
|
|
||||||
|
## Build from source
|
||||||
|
|
||||||
|
Maintainers can build the collection into a temporary directory after
|
||||||
|
installing `requirements.yml`:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
build_dir=$(mktemp -d)
|
build_dir=$(mktemp -d)
|
||||||
@@ -22,10 +40,6 @@ ansible-galaxy collection install \
|
|||||||
"$build_dir/rakestraw-dnd-0.1.0.tar.gz" --no-deps
|
"$build_dir/rakestraw-dnd-0.1.0.tar.gz" --no-deps
|
||||||
```
|
```
|
||||||
|
|
||||||
The development manifest uses immutable role commit pins. A future released
|
|
||||||
collection may instead consume reviewed role tags; this repository does not
|
|
||||||
claim that version `0.1.0` has been published or tagged.
|
|
||||||
|
|
||||||
## Use
|
## Use
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
|
|||||||
@@ -3,23 +3,23 @@ roles:
|
|||||||
- name: rakestraw.seriatim
|
- name: rakestraw.seriatim
|
||||||
src: https://gitea.maximumdirect.net/eric/ansible-role-seriatim.git
|
src: https://gitea.maximumdirect.net/eric/ansible-role-seriatim.git
|
||||||
scm: git
|
scm: git
|
||||||
version: e08c63c0b078658bdfa2d10a2e6e1e4f9372a075
|
version: v0.1.0
|
||||||
- name: rakestraw.audita
|
- name: rakestraw.audita
|
||||||
src: https://gitea.maximumdirect.net/eric/ansible-role-audita.git
|
src: https://gitea.maximumdirect.net/eric/ansible-role-audita.git
|
||||||
scm: git
|
scm: git
|
||||||
version: 66ebea9a47ce82bfdbdc5e2855f3dfaaff8e2a16
|
version: v0.1.0
|
||||||
- name: rakestraw.notarius
|
- name: rakestraw.notarius
|
||||||
src: https://gitea.maximumdirect.net/eric/ansible-role-notarius.git
|
src: https://gitea.maximumdirect.net/eric/ansible-role-notarius.git
|
||||||
scm: git
|
scm: git
|
||||||
version: 14a38e04e35ef524d6a97fa7fb5a04981a0a2161
|
version: v0.1.0
|
||||||
- name: rakestraw.scriptorium
|
- name: rakestraw.scriptorium
|
||||||
src: https://gitea.maximumdirect.net/eric/ansible-role-scriptorium.git
|
src: https://gitea.maximumdirect.net/eric/ansible-role-scriptorium.git
|
||||||
scm: git
|
scm: git
|
||||||
version: 8b4c86e48e7d8655e479b26dc510bf01683a0c8f
|
version: v0.1.0
|
||||||
- name: rakestraw.narratio
|
- name: rakestraw.narratio
|
||||||
src: https://gitea.maximumdirect.net/eric/ansible-role-narratio.git
|
src: https://gitea.maximumdirect.net/eric/ansible-role-narratio.git
|
||||||
scm: git
|
scm: git
|
||||||
version: 292d8669e7aad5cfe80b0c469d22b6177e8cf0f1
|
version: v0.1.0
|
||||||
collections:
|
collections:
|
||||||
- name: ansible.posix
|
- name: ansible.posix
|
||||||
version: 2.2.0
|
version: 2.2.0
|
||||||
|
|||||||
Reference in New Issue
Block a user