Jump to content

MariaDB/Cookbooks

From Wikitech

This page documents the cookbooks for managing MariaDB infrastructure

(Please keep them in alphabetical order)

sre.mysql.clone-es

Clones an External Storage (ES) sections onto a new target host

  • Pool/depool source and target host as needed
  • Set silences as needed
  • Add the new host to Zarcillo

Team use only.

sre.mysql.clone

Clones a MariaDB database host to a new target host

  • Pool/depool source and target host as needed
  • Set silences as needed
  • Add the new host to Zarcillo

Team use only.

sre.mysql.decommission

MariaDB host decommissioning helper:

  • Performs safety checks before decommissioning
  • Tracks task creation and Puppet patches
  • Depools the target host
  • Removes it from Zarcillo and Orchestrator
  • Updates associated Phab task and handoff to DC-Ops

Team use only.

sre.mysql.depool

Depools a MariaDB database instance or host from active traffic using dbctl

  • Detects special sections like pc* where the whole section needs depooling
  • Optionally add Icinga/AlertManager downtime

This cookbook is for all SREs.

sre.mysql.global-read-only

Sets or unsets sections flag tor read-only:

  • Idempotent operation that updates dbctl
  • Also executes SET GLOBAL read_only=... directly on MariaDB instances
  • Updates tracking details in Phabricator

This cookbook is for all SREs.

sre.mysql.major-upgrade

Perform major version upgrades of MariaDB and support OS reimaging

Team use only.

sre.mysql.parsercache

Pools or depools parsercache (pc) and mainstash (ms) database hosts via dbctl It is used by the pool/depool cookbooks

Team use only.

sre.mysql.pool

Pools a MariaDB instance into production using dbctl

  • Detects special sections like pc* where the whole section needs depooling
  • Perform safety checks before pooling
  • Removes Icinga/Alertmanager downtime

This cookbook is for all SREs.

sre.mysql.sanitarium_restart

Restarts Sanitarium hosts

Team use only.

sre.mysql.sanitize-wiki

Sanitizes private data (PII) on newly created wikis

Team use only.

sre.mysql.update-replication

Configures MariaDB replication between a master and replica:

  • Stops replication on the destination (replica) instance
  • Executes the CHANGE MASTER ... query
  • Restarts replication on the replica without modifying the master host

Team use only.

sre.mysql.upgrade

Upgrades the minor package version of MariaDB

Team use only.