NSLS-II Deployment Documentation

This documentation describes how we deploy the “bluesky” software suite and associated configuration at NSLS-II. It is maintained as both an internal reference and a public guide for collaborators or potential collaborators who may be interested in our process.

Components

• Conda
  • Conda Installation
  • Conda Server
  • Conda Configuration Files
  • Conda Environments
  • Conda Environment Files
  • Conda Metapackages
• NSLS-II DAMA Ansible Playbooks
  • Getting Started
  • Organization
    • Inventories
    • Playbooks
  • Deploying
    • A Simple Ping Test to Get Started
    • JupyterHub
    • Beamlines
    • Changing default environments
      • Where to Make Changes
    • Updating conda
    • New hosts
    • New databroker configuration
    • New Environments
    • New kernels
    • Fresh installation

Deployment Procedures

• Deployment Timeline
  • T - 6 Weeks
  • T - 4.5 Weeks
  • T - 4 Weeks
  • T - 3 Weeks
  • T - 2 Weeks
  • T - 1 Week
• Releasing Software
  • Obtain access to the project on PyPI
  • Tag and release
  • Update NSLS-II Conda Recipes
• Re-syncing Conda
• Deploying New Environments
  • Overview
  • Updating the Metapackages
    • Revoking a Bad Metapackage
  • Defining Environments
  • Deploying the Environments
• Upgrading Beamlines
  • Test the new environment
  • Change bsui’s default environment

NSLS-II GitHub organizations

• NSLS-II GitHub organizations

Incident Reports

• 2018-08-07 Incompatible Qt Binaries