Skip to main content

Runbooks

Use these runbooks during normal operations and incidents.

Runbook: First Production App​

  1. Create or confirm production environment.
  2. Open Applications.
  3. Create app from connected repository or manual URL.
  4. Set branch.
  5. Choose web service or static site.
  6. Add variables.
  7. Deploy.
  8. Watch logs.
  9. Open generated Moltern URL.
  10. Add custom domain.
  11. Confirm domain active.
  12. Review billing usage.
  13. Record owner and recovery notes.

Runbook: Failed Application Deploy​

  1. Open dashboard.
  2. Filter by failed.
  3. Open the app.
  4. Open Live Logs.
  5. Identify the first failing step.
  6. Check repository access, commands, port, variables, and quota.
  7. Fix the cause.
  8. Deploy again.
  9. Confirm running status.
  10. Open the URL.

Runbook: Service Failed​

  1. Open dashboard failed filter.
  2. Open the service.
  3. Read recovery guidance.
  4. Open live logs.
  5. Check required configuration.
  6. Check billing and quota.
  7. Retry only after fixing the likely cause.
  8. If stateful, confirm owner before deleting or redeploying.

Runbook: Service Sleeping Before Demo​

  1. Open service detail page.
  2. Click Wake service.
  3. Wait for running status.
  4. Open the URL.
  5. Keep the page warm until the demo starts.
  6. Consider plan change if the service must never sleep.

Runbook: Custom Domain Pending​

  1. Open workload settings.
  2. Confirm the domain spelling.
  3. Copy the current records shown in Moltern.
  4. Check those records in the domain provider UI.
  5. Wait for propagation.
  6. Click Check now.
  7. If verification fails, remove and re-add the domain.

Runbook: Resize Request​

  1. Open workload detail page.
  2. Enter proposed size.
  3. Click Preview.
  4. Read warnings and billing impact.
  5. If blocked, open Billing.
  6. Adjust size, quota, or plan.
  7. Apply only when allowed.
  8. Watch status until running.
  9. Record why the size changed.

Runbook: Workload Quota Full​

  1. Open Billing.
  2. Review workload count.
  3. Open dashboard.
  4. Identify unused apps and services.
  5. Delete temporary workloads after owner approval.
  6. Remove empty environments.
  7. Retry deploy.
  8. Upgrade plan only if the workload is still required.

Runbook: Secret Rotation​

  1. Generate new value in the source system.
  2. Open workload settings.
  3. Replace the variable.
  4. Save variables.
  5. Redeploy or restart if required.
  6. Confirm workload is healthy.
  7. Revoke old value in the source system.
  8. Record rotation completion without storing the secret.

Runbook: Remove A Service​

  1. Confirm owner approval.
  2. Open service detail page.
  3. Review dependencies.
  4. Click delete.
  5. Read the preview.
  6. Confirm only expected resources are listed.
  7. Confirm deletion.
  8. Wait for redirect or status change.
  9. Refresh dashboard.
  10. Remove stale domains or external bookmarks.

Runbook: Webhook Not Delivered​

  1. Open Webhooks.
  2. Confirm endpoint exists.
  3. Confirm event type is selected.
  4. Confirm the URL starts with https://.
  5. Confirm the receiving system is live.
  6. Confirm the secret matches.
  7. Trigger a new deployment event.
  8. Check receiver logs.
  9. Recreate the endpoint if the secret is unknown.