Commit 928d13d1 authored by Kristin's avatar Kristin Committed by Laura, Jason R
Browse files

Updated Public Release Process (markdown)

parent 79d53b70
Loading
Loading
Loading
Loading
+8 −6
Original line number Diff line number Diff line
@@ -85,8 +85,10 @@ Anaconda leverages caching in many places which can cause issues. If you are get
* Run ```conda build recipe/ -c usgs-astrogeology -c conda-forge --no-test```
  * The -c options are to give conda a channel priority. Without these, conda will always attempt to download from the default Anaconda channel first. (Unlike the environment.yml files, channel priority cannot be defined within the meta.yaml.)
  * Since we do not have testing set-up through conda, the “--no-test” flag must be set in order to avoid errors. (By default, conda looks for a run_test file and will throw an error if it can not be located.)
## Step 4: Test the Conda Build

## Step 4: Upload the Build to Anaconda Cloud

## Step 5: Upload the Build to Anaconda Cloud

In this step, we will upload the build(s) that we just created into the Anaconda Cloud to distribute them to our users. Uploading the .tar.bz2 file requires one command, however, non-standard builds (release candidates or custom builds), must be uploaded with a label. 

@@ -99,12 +101,12 @@ In this step, we will upload the build(s) that we just created into the Anaconda

If the upload fails or displays a prompt for a username and password, try adding an API token for usgs-astrogeology to your environment by running `export ANACONDA_API_TOKEN=<token>`. Ask another developer for the API token. This approach is recommended over adding `-t <token>` to your anaconda upload command, because of a known bug where `-t` is either interpreted as a package type or a token depending on its position in the `anaconda upload` command. 

## Step 5: Back up the Build 
## Step 6: Back up the Build 
Back up the build by copying the .tar.bz2 to:
  * /work/projects/conda-bld/osx-64/ for Mac OS 10.13. 
  * /work/projects/conda-bld/linux-64/ for Ubuntu 18 LTS.

## Step 6: Update Data and TestData Areas on rsync Servers
## Step 7: Update Data and TestData Areas on rsync Servers

This step covers how to update the data on the rysnc servers. This is where our external users will have access to the data necessary for running ISIS. One server is located on campus, while the other server is located in Phoenix. These commands must be run as isis3mgr for permission purposes.

@@ -121,7 +123,7 @@ This step covers how to update the data on the rysnc servers. This is where our

* Actually copy the files using ```rsync -rtpvl /usgs/cpkgs/isis3/data/ isisdist.astrogeology.usgs.gov:/work1/dist/isis3/<isis3data or mission specific>/data/```.

## Step 7: Create Internal Builds/Installs for Astro
## Step 8: Create Internal Builds/Installs for Astro

This step covers creating the builds and the installation environments of ISIS for our internal users here on the ASC campus using the shared anaconda installs. Setting up the conda environments involve installing the conda build of ISIS that we just pushed up to Anaconda, and will follow the instructions found in the README.MD of the isis3 repository. These commands must be run as isis3mgr for permission purposes.

@@ -137,7 +139,7 @@ This step covers creating the builds and the installation environments of ISIS f
    * For a custom build, the environment should be named `isisX.Y.Z-<custom-label>`.
* Confirm that the environment has been set-up properly by deactivating it, reactivating it, and running an application of your choice.

## Step 8: Update Documentation
## Step 9: Update Documentation

**This step is only done for standard releases.**

@@ -151,7 +153,7 @@ This step will update the ISIS documentation on our [website](https://isis.astro
### Part B: Upload the documentation
* In the isis/src/docsys directory (this directory is in the ISIS source tree) run the command ```make wwwdoc```.

## Step 9: Communicate Availability of Build
## Step 10: Communicate Availability of Build

This step will will communicate that a new version of ISIS is available.