artefactual / artefactual/deploy-pub

Problem: playbooks/archivematica doesn't explain how to deploy QA

Open
#45 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
Shell
Stars
14
Forks
13
Avg merge
5d 14h
Merged PRs (30d)
2

Description

As f80bf57aad47e166c28ad19a8a828b61b9547e82, if someone tries to deploy Archiveamtica using the deploy-pub/playbooks/archivematica it's unclear for a newcomer if stable or qa branches are being deployed. This just beat @mcantelon which is a sign that we're doing a poor job explaining it.

I suggest to have two environments:
- `deploy-pub/playbooks/archivematica`
- `deploy-pub/playbooks/archivematica-qa`

Or we could do a better job in the README file explaning how to download the right branch of the AM role (e.g. qa/1.7.x branch targets AM 1.7 and so on) and the right vars file.

Contributor guide

No contributing guide indexed for this repository

Research direction

Read deploy-pub/playbooks/archivematica and the README it references, then inspect how the ArchiveMatic role branch and vars file are selected. Decide whether separate QA playbooks or clearer README guidance best fits the repository; done means a newcomer can distinguish stable from QA deployment and select the matching branch and vars.

Written by the indexing model from the issue text.

Assessment

Tech stack
shell
Domain
devops, documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.