You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: doc/playbook.rst
+14-4Lines changed: 14 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,10 +29,14 @@ All containers are managed by `GitHub Container Registry <https://github.com/org
29
29
To build the base container:
30
30
31
31
* If there are changes to the container, push them to a branch, then open a PR.
32
-
The container should be built automatically.
33
-
* If there are no changes (typically because you want to use an updated Science Pipelines container), go to the repository's `Actions tab <https://github.com/lsst-dm/prompt_processing/actions/workflows/build-base.yml>`_ and select "Run workflow".
34
-
From the dropdown, select the branch whose container definition will be used, and the label of the Science Pipelines container.
35
-
* New containers built from ``main`` are tagged with the corresponding Science Pipelines release (plus ``w_latest`` or ``d_latest`` if the release was requested by that name).
32
+
This will build the container automatically.
33
+
* If there are no changes (typically because you want to use an updated Science Pipelines container), go to the repository's `Actions tab <https://github.com/lsst-dm/prompt_processing/actions/workflows/build-base.yml>`_ and select "**Run workflow**". From the dropdown menu, select:
34
+
35
+
#. The branch whose container definition will be used
36
+
#. The label of the Science Pipelines container.
37
+
#. If using a quick-stack build, the Science Pipelines Container should be set to `ghcr.io/lsst/quick-stack <https://ghcr.io/lsst/quick-stack>`_.
38
+
39
+
New containers built from ``main`` are tagged with the corresponding Science Pipelines release (plus ``w_latest`` or ``d_latest`` if the release was requested by that name).
36
40
For automatic ``main`` builds, or if the corresponding box in the manual build is checked, the new container also has the ``latest`` label.
37
41
Containers built from a branch use the same scheme, but prefixed by the ticket number or, for user branches, the branch topic.
38
42
@@ -68,6 +72,12 @@ Any subsequent builds of the service container will build against both bases.
68
72
69
73
This is the only situation in which a change to ``BASE_TAG_LIST`` should be committed to ``main``.
70
74
75
+
It will sometimes be necessary to compile a container with the LSST Science Pipelines manually (called a Quick-Stack build).
76
+
Generally, this only occurs if the intended daily or weekly stack does not compile.
77
+
In these cases, the Science Pipelines themselves must be built ahead of the base container.
78
+
Instructions for building the Science Pipelines are `here <https://github.com/lsst/gha_build/blob/main/README.md>`_.
79
+
For Prompt Processing, we only need to build `lsst_distrib`.
0 commit comments