Argus
Description
Argus is a test tracking system intended to provide observability into automated test pipelines which use long-running resources. It allows observation of a test status, its events and its allocated resources. It also allows easy comparison between particular runs of a specific test.
Contributing
Review the Repository Guidelines for project structure, tooling expectations, and pull request practices before submitting changes.
Installation notes
Development
For development setup instructions, see dev-setup.md.
Prerequisites
-
Python >=3.10.0 (system-wide or pyenv)
-
NodeJS >=16 (with npm)
-
Yarn (can be installed globally with
npm -g install yarn) -
nginx
-
uv
From source
Production
Perform the following steps:
Create a user that will be used by uwsgi:
useradd -m -s /bin/bash argus
sudo -iu argus
(Optional) Install pyenv and create a virtualenv for this user:
pyenv install 3.10.0
pyenv virtualenv argus
pyenv activate argus
Clone the project into a directory somewhere where user has full write permissions
git clone https://github.com/scylladb/argus ~/app
cd ~/app
Install project dependencies:
uv sync --all-extras
yarn install
Compile frontend files from /frontend into /public/dist
yarn build
Create a argus.local.yaml configuration file (used to configure database connection) and a argus_web.yaml (used for webapp secrets) in your application install directory.
cp argus_web.example.yaml argus_web.yaml
cp argus.yaml argus.local.yaml
Open argus.local.yaml and add the database connection information (contact_points, user, password and keyspace name).
Open argus_web.yaml and change the SECRET_KEY value to something secure, like a sha512 digest of random bytes. Fill out GITHUB_* variables with their respective values.
Copy nginx configuration file from docs/configs/argus.nginx.conf to nginx virtual hosts directory:
Ubuntu:
sudo cp docs/configs/argus.nginx.conf /etc/nginx/sites-available/argus
sudo ln -s /etc/nginx/sites-enabled/argus /etc/nginx/sites-available/argus
RHEL/Centos/Alma/Fedora:
sudo cp docs/configs/argus.nginx.conf /etc/nginx/conf.d/argus.conf
Adjust the webhost settings in that file as necessary, particularly listen and server_name directives.
Copy systemd service file from docs/config/argus.service to /etc/systemd/system directory:
sudo cp docs/config/argus.service /etc/systemd/system
Open it and adjust the path to the start_argus.sh script in the ExecStart= directive and the user/group, then reload systemd daemon configuration and enable (and optionally start) the service.
WARNING: start_argus.sh assumes pyenv is installed into ~/.pyenv
sudo systemctl daemon-reload
sudo systemctl enable --now argus.service
uwsgi.ini logs to /var/log/argus/argus.log; make sure that directory exists and is writable by the argus user, then install log rotation by copying docs/config/argus.logrotate to /etc/logrotate.d/argus:
sudo mkdir -p /var/log/argus
sudo chown argus:argus /var/log/argus
sudo cp docs/config/argus.logrotate /etc/logrotate.d/argus
3 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file argus_alm-0.16.1.tar.gz.
File metadata
- Download URL: argus_alm-0.16.1.tar.gz
- Upload date:
- Size: 2.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
52ad71e5cbdc49f2e4ae84c670f70f13fd9b024f6124c352e894bec610042d21
|
|
| MD5 |
86908a9ef7407d7a33763b8d8879958b
|
|
| BLAKE2b-256 |
48c8e704d6e2643723acb10722f3ef373f67a7ff9878a58564aeee66289745a3
|
Provenance
The following attestation bundles were made for argus_alm-0.16.1.tar.gz:
Publisher:
release.yml on scylladb/argus
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
argus_alm-0.16.1.tar.gz -
Subject digest:
52ad71e5cbdc49f2e4ae84c670f70f13fd9b024f6124c352e894bec610042d21 - Sigstore transparency entry: 2206758548
- Sigstore integration time:
-
Permalink:
scylladb/argus@089449430f85e93b9573207ec3d142b20c7d19ae -
Branch / Tag:
refs/tags/v0.16.1 - Owner: https://github.com/scylladb
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@089449430f85e93b9573207ec3d142b20c7d19ae -
Trigger Event:
push
-
Statement type:
File details
Details for the file argus_alm-0.16.1-py3-none-any.whl.
File metadata
- Download URL: argus_alm-0.16.1-py3-none-any.whl
- Upload date:
- Size: 51.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
32b04433a1bf377db00395f55d98dec9e16ffd2553b0a4c99daec48c4eeb00d4
|
|
| MD5 |
f2b48e30f6a75b92c885b6e8604c990d
|
|
| BLAKE2b-256 |
30207d16d8f2edda19fe9270d717fbe5d98d5f3dbd64a16079337ae7633afb14
|
Provenance
The following attestation bundles were made for argus_alm-0.16.1-py3-none-any.whl:
Publisher:
release.yml on scylladb/argus
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
argus_alm-0.16.1-py3-none-any.whl -
Subject digest:
32b04433a1bf377db00395f55d98dec9e16ffd2553b0a4c99daec48c4eeb00d4 - Sigstore transparency entry: 2206758665
- Sigstore integration time:
-
Permalink:
scylladb/argus@089449430f85e93b9573207ec3d142b20c7d19ae -
Branch / Tag:
refs/tags/v0.16.1 - Owner: https://github.com/scylladb
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@089449430f85e93b9573207ec3d142b20c7d19ae -
Trigger Event:
push
-
Statement type:
