Week 1 infrastructure: Docker environments, deploy pipeline, bookstore-core scaffold

Docker Compose environments for dev/staging/production (MariaDB, Redis, Caddy, Action Scheduler cron sidecar), an idempotent deploy script, git-hook-based deploy pipeline, backup/restore scripts, and the bookstore-core plugin stub with WooCommerce HPOS compatibility declared. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-27 09:50:18 -04:00
commit c9d637c907
23 changed files with 757 additions and 0 deletions
@@ -0,0 +1,76 @@
+#!/usr/bin/env bash
+# Builds and brings up an environment, then makes sure WordPress/WooCommerce
+# are installed and configured to match design doc §01/§03/§07. Safe to run
+# repeatedly — every step is idempotent.
+set -euo pipefail
+
+ENVIRONMENT="${1:?Usage: deploy.sh <dev|staging|production>}"
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$REPO_ROOT"
+
+case "$ENVIRONMENT" in
+  dev|staging|production) ;;
+  *) echo "environment must be 'dev', 'staging', or 'production'" >&2; exit 1 ;;
+esac
+
+ENV_FILE=".env.${ENVIRONMENT}"
+if [[ ! -f "$ENV_FILE" ]]; then
+  echo "missing $ENV_FILE — copy .env.example to $ENV_FILE and fill it in" >&2
+  exit 1
+fi
+set -a
+# shellcheck disable=SC1090
+source "$ENV_FILE"
+set +a
+
+COMPOSE="docker compose -f docker-compose.yml -f docker-compose.${ENVIRONMENT}.yml --env-file ${ENV_FILE}"
+
+echo "==> building and starting ${ENVIRONMENT}"
+$COMPOSE up -d --build
+
+echo "==> waiting for the wordpress container to come up"
+for i in $(seq 1 30); do
+  if $COMPOSE exec -T wordpress php -v >/dev/null 2>&1; then
+    break
+  fi
+  if [[ "$i" -eq 30 ]]; then
+    echo "wordpress container did not become ready in time" >&2
+    exit 1
+  fi
+  sleep 2
+done
+
+echo "==> ensuring WordPress is installed"
+if ! $COMPOSE exec -T wordpress wp core is-installed --allow-root; then
+  $COMPOSE exec -T wordpress wp core install \
+    --url="${SITE_URL:?set SITE_URL in ${ENV_FILE}}" \
+    --title="${SITE_TITLE:-Bookstore}" \
+    --admin_user="${WP_ADMIN_USER:?set WP_ADMIN_USER in ${ENV_FILE}}" \
+    --admin_password="${WP_ADMIN_PASSWORD:?set WP_ADMIN_PASSWORD in ${ENV_FILE}}" \
+    --admin_email="${WP_ADMIN_EMAIL:?set WP_ADMIN_EMAIL in ${ENV_FILE}}" \
+    --skip-email \
+    --allow-root
+fi
+
+echo "==> installing/activating theme (Blocksy — free; Book Store starter site needs a manual license + import, see README)"
+$COMPOSE exec -T wordpress wp theme install blocksy --activate --allow-root
+
+echo "==> installing/activating required plugins"
+$COMPOSE exec -T wordpress wp plugin install woocommerce redis-cache blocksy-companion --activate --allow-root
+$COMPOSE exec -T wordpress wp plugin activate bookstore-core --allow-root
+$COMPOSE exec -T wordpress wp redis enable --allow-root || true
+
+echo "==> enabling WooCommerce HPOS (custom order tables)"
+$COMPOSE exec -T wordpress wp option update woocommerce_custom_orders_table_enabled yes --allow-root
+$COMPOSE exec -T wordpress wp option update woocommerce_custom_orders_table_data_sync_enabled yes --allow-root
+
+if [[ "$ENVIRONMENT" != "production" ]]; then
+  echo "==> discouraging search engines (non-production)"
+  $COMPOSE exec -T wordpress wp option update blog_public 0 --allow-root
+fi
+
+echo "==> flushing caches and rewrite rules"
+$COMPOSE exec -T wordpress wp cache flush --allow-root
+$COMPOSE exec -T wordpress wp rewrite flush --allow-root
+
+echo "==> deploy complete: ${ENVIRONMENT}"