ags-server

This is a temporary packaged-up version of the Gemini AGS server with the subset of the library jars required to implement just the JSON endpoint. We can deploy this to Heroku and make it available externally.

Setting Up

First, build ags in your ocs codebase.

sbt
> project app_ags
> ocsDist Test

Now run update.sh, passing the generated bundle directory. Something like

 $ ./update.sh ../ocs/app/ags/target/ags/2021B-test.1.1.2/Test/ags/bundle/
  🔸 Reading from /Users/carlos.quiroz/code/noirlab/ocs/app/ags/target/ags/2021B-test.1.1.2/Test/ags/bundle
  🔸 Writing to   /Users/carlos.quiroz/code/noirlab/ags-server/lib
  🔸 Removing old library bundles.
  🔸 Copying bundles.

This will copy the necessary jars into the local lib/ directory.

Running

Once you're set up you can run locally with sbt run. There is a sample request in data.json so if you're in the project root you can say:

curl http://localhost:8080/json -d @data.json

and get back a response like

{
  "posAngle" : 0.0,
  "assignments" : [
    {
      "probe" : "PWFS2",
      "star" : {
        "coordinates" : {
          "ra" : "23:59:40.024",
          "dec" : "-00:03:06.95"
        },
        "name" : "450-138351",
        "magnitudes" : [
          {
            "value" : 13.061,
            "band" : "B",
            "error" : 0.02,
            "system" : "Vega"
          },
          {
            "value" : 12.622,
            "band" : "g",
            "error" : 0.01,
            "system" : "AB"
          },
          {
            "value" : 12.221,
            "band" : "V",
            "error" : 0.01,
            "system" : "Vega"
          },
      "ItcSpectroscopyResult" : {
        "ccds" : [
          {
            "wellDepth" : 125000.0,
            "peakPixelFlux" : 0.03607547711165799,
            "warnings" : [],
            "singleSNRatio" : 4.6417881419574975E-194,
            "totalSNRatio" : 7.339311472273343E-194,
            "ampGain" : 5.11
          },
          ...
        ],
        "chartGroups" : []
      }
    }
    ...
}

It may so happen that different inputs will ened up traversing into code that's not in the lib/ directory so if that happens we just need to add missing jarfile to the update script.

Deploying

To deploy you need to first be logged into Heroku and also logged into the docker registry. So

heroku login

and then

heroku container:login

You probably only need to do this once, I don't know. Anyway you can then build the app with

sbt docker:publish

which will build and upload the web image to the Docker registry for the gemini-new-itc. To deploy this new version you say

heroku container:release -a gemini-new-itc web

To watch the logs you can say

heroku logs -a gemini-new-itc -t

The endpoint for the Heroku app is

https://gemini-new-itc.herokuapp.com/