Presents a sketch of a core RSP service that uses a combination of information from Kubernetes and from individual service to satisfy the "/availability" endpoints of all our IVOA-style services associated with a single RSP instance. Also presents a proposal for a core page on the RSP web presence that displays service status based on this information.
Links:
- Publication URL: https://dmtn-186.lsst.io
- Alternative editions: https://dmtn-186.lsst.io/v
- GitHub repository: https://github.com/lsst-dm/dmtn-186
- Build system: https://github.com/lsst-dm/dmtn-186/actions/
You can clone this repository and build the technote locally with Sphinx:
git clone https://github.com/lsst-dm/dmtn-186
cd dmtn-186
pip install -r requirements.txt
make html
Note
In a Conda environment, pip install -r requirements.txt
doesn't work as expected. Instead, pip
install the packages listed in requirements.txt
individually.
The built technote is located at _build/html/index.html
.
You can edit the index.rst
file, which is a reStructuredText document. The DM reStructuredText Style Guide is a good resource for how we write reStructuredText.
Remember that images and other types of assets should be stored in the _static/
directory of this repository. See _static/README.rst
for more information.
The published technote at https://dmtn-186.lsst.io will be automatically rebuilt whenever you push your changes to the master
branch on GitHub.
This technote's metadata is maintained in metadata.yaml
. In this metadata you can edit the technote's title, authors, publication date, etc.. metadata.yaml
is self-documenting with inline comments.
The bibliography files in lsstbib/
are copies from lsst-texmf. You can update them to the current lsst-texmf versions with:
make refresh-bib
Add new bibliography items to the local.bib
file in the root directory (and later add them to lsst-texmf).