summaryrefslogtreecommitdiff
path: root/genesishosting/provisioning
diff options
context:
space:
mode:
authordoc <doc@filenotfound.org>2025-06-30 20:06:28 +0000
committerdoc <doc@filenotfound.org>2025-06-30 20:06:28 +0000
commit717fcb9c81d2bc3cc7a84a3ebea6572d7ff0f5cf (patch)
tree7cbd6a8d5046409a82b22d34b01aac93b3e24818 /genesishosting/provisioning
parent8368ff389ec596dee6212ebeb85e01c638364fb3 (diff)
uploading documentationHEADmaster
Diffstat (limited to 'genesishosting/provisioning')
-rw-r--r--genesishosting/provisioning/checklist.md23
-rw-r--r--genesishosting/provisioning/post-deploy-verification.md22
-rw-r--r--genesishosting/provisioning/whmcs-integration.md23
3 files changed, 68 insertions, 0 deletions
diff --git a/genesishosting/provisioning/checklist.md b/genesishosting/provisioning/checklist.md
new file mode 100644
index 0000000..13741d3
--- /dev/null
+++ b/genesishosting/provisioning/checklist.md
@@ -0,0 +1,23 @@
+# Provisioning Checklist
+
+This checklist is followed every time a new service is deployed.
+
+## Pre-Provisioning
+
+- [ ] Verify order and payment in WHMCS
+- [ ] Confirm product mapping is correct
+- [ ] Check available server resources
+
+## Provisioning
+
+- [ ] Trigger appropriate script/module
+- [ ] Log provisioning result
+- [ ] Assign DNS entries if applicable
+- [ ] Generate Let’s Encrypt SSL if public-facing
+
+## Post-Provisioning
+
+- [ ] Send welcome email via WHMCS
+- [ ] Confirm monitoring alert is active
+- [ ] Test login credentials and endpoints
+- [ ] Label service with client ID in Grafana/Prometheus
diff --git a/genesishosting/provisioning/post-deploy-verification.md b/genesishosting/provisioning/post-deploy-verification.md
new file mode 100644
index 0000000..d46f727
--- /dev/null
+++ b/genesishosting/provisioning/post-deploy-verification.md
@@ -0,0 +1,22 @@
+# Post-Deployment Verification
+
+All services go through a post-deploy QA check to ensure they're live and stable.
+
+## Verification Tasks
+
+- [ ] Service reachable from public IP or internal route
+- [ ] DNS resolves correctly (for domains/subdomains)
+- [ ] SSL certificate is active and trusted
+- [ ] Admin login works as expected
+- [ ] Usage quotas correctly applied (disk, users, bandwidth)
+
+## Monitoring
+
+- [ ] Add to Prometheus for service-specific metrics
+- [ ] Set alert thresholds (e.g., disk > 80%)
+- [ ] Confirm Telegram/Mastodon alert webhook is functional
+
+## Documentation
+
+- [ ] Log final status in WHMCS admin notes
+- [ ] Store internal service details in `genesis-inventory.yaml`
diff --git a/genesishosting/provisioning/whmcs-integration.md b/genesishosting/provisioning/whmcs-integration.md
new file mode 100644
index 0000000..3f5663d
--- /dev/null
+++ b/genesishosting/provisioning/whmcs-integration.md
@@ -0,0 +1,23 @@
+# WHMCS Integration
+
+WHMCS handles client billing, service provisioning, and support workflows.
+
+## Services Integrated
+
+| Service | Method |
+|--------------|---------------------------------|
+| DirectAdmin | Built-in WHMCS module |
+| AzuraCast | Custom provisioning script |
+| TeamTalk | API + XML user patching scripts |
+
+## Auto-Provisioning Steps
+
+1. Client signs up and completes payment
+2. WHMCS triggers product-specific hook
+3. Script/module provisions the service
+4. Welcome email is sent with credentials
+
+## Logging & Troubleshooting
+
+- Logs stored at `/var/log/whmcs-hooks.log`
+- Errors generate internal ticket automatically if provisioning fails