diff options
Diffstat (limited to 'source/releases.rst')
| -rw-r--r-- | source/releases.rst | 99 |
1 files changed, 82 insertions, 17 deletions
diff --git a/source/releases.rst b/source/releases.rst index ab53a9a..641adb1 100644 --- a/source/releases.rst +++ b/source/releases.rst @@ -30,10 +30,10 @@ Example .. code-block:: sh conda create -n demo_2016.1 \ - --file http://ssb.stsci.edu/conda/hstdp-2016.1/hstdp-2016.1-linux-py35.2.txt + --file http://ssb.stsci.edu/releases/hstdp/2016.1/hstdp-2016.1-linux-py35.0.txt source activate demo_2016.1 -The URL used here will not be updated to reflect the latest iteration available. Please consult the :ref:`files` section to ensure you are installing the correct release. +The URL shown in this example does not necessarily reflect the latest iteration available. Please consult the :ref:`files` section to ensure you are installing the correct release. .. _files: @@ -54,8 +54,8 @@ HST Data Processing (HSTDP) ======== ====== === PLATFORM Python URL ======== ====== === -Linux 3.5 http://ssb.stsci.edu/conda/hstdp-2016.1/hstdp-2016.1-linux-py35.2.txt -OS X 3.5 http://ssb.stsci.edu/conda/hstdp-2016.1/hstdp-2016.1-osx-py35.2.txt +Linux 3.5 http://ssb.stsci.edu/releases/hstdp/2016.1/hstdp-2016.1-linux-py35.final.txt +OS X 3.5 http://ssb.stsci.edu/releases/hstdp/2016.1/hstdp-2016.1-osx-py35.final.txt ======== ====== === 2016.2 @@ -64,23 +64,88 @@ OS X 3.5 http://ssb.stsci.edu/conda/hstdp-2016.1/hstdp-2016.1-osx-py35. ======== ====== === PLATFORM Python URL ======== ====== === -Linux 3.5 http://ssb.stsci.edu/conda/hstdp-2016.2/hstdp-2016.2-linux-py35.2.txt -OS X 3.5 http://ssb.stsci.edu/conda/hstdp-2016.2/hstdp-2016.2-osx-py35.2.txt +Linux 3.5 http://ssb.stsci.edu/releases/hstdp/2016.2/hstdp-2016.2-linux-py35.final.txt +OS X 3.5 http://ssb.stsci.edu/releases/hstdp/2016.2/hstdp-2016.2-osx-py35.final.txt ======== ====== === -Release Schema -============== +2017.2 +++++++ + +======== ====== === +PLATFORM Python URL +======== ====== === +Linux 3.5 http://ssb.stsci.edu/releases/hstdp/2017.2/hstdp-2017.2-linux-py35.final.txt +OS X 3.5 http://ssb.stsci.edu/releases/hstdp/2017.2/hstdp-2017.2-osx-py35.final.txt +======== ====== === -If you wish to write shell scripts to manage your local pipeline installations, this may be of interest to you: -.. code-block:: sh +Continuous Integration +====================== - RELEASE_HOME=http://ssb.stsci.edu/conda +This example BASH function provides a starting point for users intending to execute pipeline software from within a continuous integration environment. This installation method is unsupported and your mileage may vary. Use at your own risk. - # hstdp 2016 1 - # ^ ^ ^ - RELEASE_PARENT=$NAME-$YEAR.$BUILD +.. code-block:: sh - # linux py35 2 - # ^ ^ ^ - RELEASE_CHILD=$RELEASE_PARENT-$PLATFORM-$PYTHON_VERSION.$ITERATION.txt + function get_pipeline() + { + # Do we have enough arguments? + if [[ $# < 3 ]]; then + echo "Not enough arguments." + return 1 + fi + + # Setup basic argument list & Example Input(s) + local conda_env="$1" # hst_env + local name="$2" # hstdp, ... + local build="$3" # 2017.2, 2016.2 ... + local python_version="$4" # py[35, 27, ...] + local iteration="$5" # final | post[0, 1, 2, ...] + + # Detect platform + local _platform=$(uname -s) + local platform="" + + # Convert platform string to match file naming convention + if [[ ${_platform} == Linux ]]; then + platform="linux" + elif [[ ${_platform} == Darwin ]]; then + platform="osx" + else + echo "Unsupported platform: ${_platform}" + return 1 + fi + unset _platform + + # Handle optional arguments. + if [[ -z ${python_version} ]]; then + # Notice the "py" prefix and condensed version here + python_version="py35" + fi + + if [[ -z ${iteration} ]]; then + iteration="final" + fi + + # Assemble pipeline spec file URL + local ac_root="http://ssb.stsci.edu/releases" + local ac_base="${ac_root}/${name}/${build}" + local ac_spec="${name}-${build}-${platform}-${python_version}.${iteration}.txt" + local ac_url="${ac_base}/${ac_spec}" + + # Perform installation + conda create -q -n "${conda_env}" --file "${ac_url}" + return $? + } + + # + # Usage example: + # + + # Silently generate a pipeline environment called "hst_env" + get_pipeline hst_env hstdp 2017.2 + + # Enter environment + source activate hst_env + + # ... do work ... + # EOF |