Skip to main content
Back to top
Ctrl
+
K
Development
API reference
Usage
Infrastructure
About this documentation project
GitLab
PyPI
System Status
Software Heritage Homepage
Development
API reference
Usage
Infrastructure
About this documentation project
GitLab
PyPI
System Status
Software Heritage Homepage
Section Navigation
Getting started
Reference: Setup sysadm repositories
Puppet
Puppet setup
Tutorial: Making my first change in Puppet
How to manage Third-Party modules
How to test Puppet changes in Vagrant
How to deploy a Puppet change
How to renew an agent certificate
Reference: Architecture of the Software Heritage Puppet deployment
Reference: Puppet best practices
Network architecture
Reference: Network configuration
How to access firewall settings
How to access firewall nodes without the vpn
How to upgrade firewall OS
Service urls
iDRAC
DNS servers
Server Architecture (Physical/Virtual)
How to provision a new VM
How to install a new physical server
How to upgrade a machine
How to search the inventory
Reference: Inventory of machines
Reference: Baseline for hardware purchases
Backups
Backup infrastructure
How to access backups
Software Architecture
Software stories
IRC Alert Manager
Data silos
PostgreSQL
How to connect to PostgreSQL databases
How to manage the PostgreSQL backups
Cassandra
How to install a cassandra node
How to upgrade a cassandra cluster
Kafka
Reference: Manage topics
ElasticSearch
Winery Deployment
Winery Network Documentation
Winery Frontends Documentation
Winery Ceph Architecture
Winery Procedures
Install a new server
Accessing the winery cluster
VPN procedures
Switches procedures
Frontends procedures
Procedures related to ceph
SWH Software Deployment
Reference: Deployment Environments
Upgrade swh service
How to deploy a new lister
How to handle a storage database migration
Debian packaging
Jenkins
ArgoCD
Add-forge-now automation
How to process add-forge-now requests
How to add journal user credential
How to bulk ingest a list of origins
How to run the swh stack in a local kubernetes cluster
How to reset the next version environment
How to deploy swh.graph in production?
Webhooks Svix
User management
Reference: Onboarding checklist
Reference: Outboarding checklist
How to manage the credentials store
Keycloak
Authentication
Realm administration
OpenVPN
How to configure OpenVPN
softwareheritage-ca.crt
Life-cycle management
How to manage upgrades of tools and software inventory
How to devise the backup strategy for a (new) service
Mirror Operations
Hosting a mirror
How to deploy a mirror
Deploy a Software Heritage stack with docker deploy
Takedown notices on mirrors
How to onboard a mirror
How to monitor a mirror
Support services
Azure Kubernetes Service
Azure Kubernetes Service howtos
Gitlab
Gitlab installation
Rancher
Rancher howtos
Infrastructure
Server Architecture (Physical/Virtual)
Reference: Baseline for hardware purchases
Reference: Baseline for hardware purchases
#
Todo
This page is a work in progress.
Edit
This Page
Show Source
