Install

This page covers the local prerequisites for working with the packaged CLI tools in deploy/.

Prerequisites

The package metadata in deploy/pyproject.toml currently declares Python >3.12. In practice, use a current Python 3.13+ interpreter unless project constraints require an older runtime.

You should also have:

  • git
  • python3
  • pip
  • AWS CLI configured with the profiles you need for the target environments

Install From The Package Index

If the package has already been published to the internal package location, install it with:

python3 -m pip install sls --extra-index-url https://packages.terragote.ch

Installed command-line entry points:

  • slservice
  • sladmin

Install From A Local Checkout

From the deploy/ directory:

python3 -m pip install .

For an editable local development install:

python3 -m pip install -e .

If you want the test dependency set used by the deploy package:

python3 -m pip install -r requirements-dev.txt

Verify The Install

From the deploy/ directory, confirm the CLIs are reachable:

slservice --help
sladmin --help

If you have not installed the package yet, you can run the scripts directly:

python3 slservice_cli.py --help
python3 sladmin_cli.py --help

Notes

  • Some commands assume AWS credentials and environment-specific access are already configured.
  • Some operational commands also depend on network access to AWS services, ECS clusters, and related infrastructure.
  • The packaged CLI lives under deploy/, even though this repository contains many other operational scripts outside that package.