Developers

Developers can deploy their applications on Rubin’s Kubernetes environments, such as the Rubin Science Platform, by integrating into Phalanx. In this section of the Phalanx documentation you can learn how to build and integrate your application, and how to test your application’s deployment in development Phalanx environments.

For background on Phalanx and how to contribute to the Phalanx repository itself, see the About section. Individual applications are documented in the Applications section.

Note

If you are maintaining Phalanx applications, contact SQuaRE to be added as a contributor to the lsst-sqre/phalanx repository. Several of the steps below requiring pushing your development branches to that repository rather than using a fork.

Build

• Building a new application

Integration

• Write a Helm chart for an application
  • Create new Helm chart from template
  • Write Chart.yaml
  • Write the Kubernetes resource templates
  • Write the values.yaml file
  • Define the application secrets
  • Checking the chart
  • Add a new application to Phalanx
  • Configuring /tmp in a container
  • Pull secrets
  • Tying service accounts to workload identity
  • Using Cloud SQL
• Adding an external Helm chart
• Sharing subcharts between applications

Deploy & maintain

• Getting application logs
• Upgrading an application
• Add or update a secret
• Deploying from a branch for development
• Switch an environment to a branch
• Resource requests and limits

Reference

• Specification for secrets.yaml files
• Values injected by Argo CD

See also

SQuaRE ran a bootcamp for Phalanx application developers in May of 2024. Rubin affiliates can watch the session recordings and see the slides of those presentations on the SQuaRE bootcamp Confluence page.