Skip to main content
Ctrl+K
Logo image

Site Navigation

  • Development
  • API reference
  • Usage
  • Infrastructure

Site Navigation

  • Development
  • API reference
  • Usage
  • Infrastructure

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
    • Kafka
      • Reference: Manage topics
    • ElasticSearch
  • 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
    • How to process add-forge-now requests
    • How to add journal user credential
  • 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
    • Gitlab
      • Gitlab installation
    • Rancher
      • Rancher howtos
  • Infrastructure
  • Puppet
  • Reference: Puppet best practices

Reference: Puppet best practices#

Todo

This page is a work in progress. Please refer to the existing documentation and the wiki page.

previous

Reference: Architecture of the Software Heritage Puppet deployment

next

Network architecture
Edit
Show Source

© Copyright 2015-2023 The Software Heritage developers.

Created using Sphinx 5.3.0.

Built with the PyData Sphinx Theme 0.13.3.