Operators

This section is for the people who deploy and run Adriano. It covers deployment, every setting and what it changes, and what to do when something goes wrong. How people use Adriano is described in the user guide; how it is built, in the developer guide.

Deploying

• Deploying Adriano
  • Docker Compose
  • Kubernetes
  • What you deploy
  • Prerequisites
  • Registering the client at your identity provider
  • Image tags and channels
  • Quick check with docker run
  • What happens at start
  • Local demo (optional)
• Configuration reference
  • Where to put settings
  • Application settings
  • Sign-in settings
  • Docker Compose settings
  • Secrets named by the catalog file
  • Settings you can ignore
• The catalog file
  • A complete example
  • Validating the file
  • Sources
  • Approval policy
  • Role permissions (rbac)
• Authentication and access
  • How sign-in works
  • Identity provider contract
  • Who may do what
  • Push tokens for CI
  • What the API answers
  • Verifying the development sign-in is off
• Connecting sources
  • GitLab
  • Filesystem
  • TLS for network sources
• Pushing candidates from CI
  • Setting up a registration for pushes
  • The push request
  • What the answer means

Running

• Polling sources
  • Scheduling polls
  • “Poll now” in the web UI
  • Poll results
  • What users see after a failed or partial poll
  • When records are removed
• Health checks and logs
  • The health endpoint
  • Container health check
  • Logs
• Backup, restore and retention
  • Backup
  • Restore
  • Retention
  • Database roles and tamper resistance
• Upgrading
  • Upgrade steps
  • How the schema update runs
  • If the update fails
• Migrating from the ADR viewer
  • What changed for clients
  • Settings
• Running several replicas
  • What is safe
  • What you must take care of
• Troubleshooting
  • Start-up
  • Sign-in and access
  • Sources and polls
  • Approval
  • CI pushes
• Command-line reference
  • adriano serve
  • adriano migrate
  • adriano check-config
  • adriano poll
  • Development-only commands