From 7da56756140c2f90fcacb541ec6bf5b1abe2c24e Mon Sep 17 00:00:00 2001 From: Anton Steketee <79179784+anton-seaice@users.noreply.github.com> Date: Wed, 22 Nov 2023 09:15:05 +1100 Subject: [PATCH] Update release.rst for review comments --- docs/management/release.rst | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/docs/management/release.rst b/docs/management/release.rst index 74424e5..5b946e3 100644 --- a/docs/management/release.rst +++ b/docs/management/release.rst @@ -10,17 +10,16 @@ person doing the release must ensure that the version of the new catalog matches following all steps below. Steps 1 and 2 below should be done in a PR and merged before commencing step 3. If the release does not include an update to the catalog on Gadi, skip the first two steps below: -#. [IF UPDATING THE CATALOG] Create a new version of the catalog on Gadi (this will take about 1 hour):: - +#. [IF UPDATING THE CATALOG] Create a new version of the catalog on Gadi (this will take about 1 hour) + :: $ export RELEASE=vX.X.X $ cd bin $ qsub -v version=${RELEASE} build_all.sh - - #. If the `schema `_ has changed, or you have not used the intake catalog recently, this step may fail with a *Network is unreachable* error trying to download the schema json files. To workaround:: + .. note:: + If the `schema `_ has changed, or you have not used the intake catalog recently, this step may fail with a *Network is unreachable* error trying to download the schema json files. To download and cache the schema, first import the `access_nri_intake.source` and `access_nri_intake.catalog` sub-packages from a Gadi node with network access (e.g. a login or ARE node). I.e., using the release version of `access_nri_intake` + :: + $ python3 -c "from access_nri_intake import source, catalog" - $ module use /g/data/hh5/public/modules/; module load conda/analysis3 - $ python3 -c "from access_nri_intake import source, catalog" - This will cache a copy of the schema in your home directory. Then re-run ``$ qsub -v version=${RELEASE} build_all.sh`` #. [IF UPDATING THE CATALOG] Upon successful completion of the previous step, the :code:`access_nri_intake` data package module