| name | deploying-to-infra |
| description | Deploy PersonalWebsite to OKD/OpenShift and work with infra scripts (okd-setup, ARC). Use when deploying, editing files under infra/, or configuring CI runners on the cluster. |
| paths | ["infra/**"] |
Deploying to Infrastructure
The application is deployed to an OpenShift/OKD cluster using a setup script.
infra/aca-setup.sh exists historically but is not used; the site is no longer hosted on Azure.
Implementation
- Main Deployment:
./infra/okd-setup.sh
- GitHub Actions Runner Controller (ARC) Setup:
./infra/arc-setup.sh
OKD Setup Process (okd-setup.sh):
- Creates or switches to the
personal-site namespace/project using oc new-project / oc project.
- Applies Kubernetes manifests defined in the script, including:
- A Deployment (
personal-site) with 3 replicas running the GHCR image.
- A ConfigMap (
nginx-config) containing the custom default.conf NGINX configuration.
- A ClusterIP Service (
personal-site) exposing port 80 (targetPort 8080).
- The deployment uses specific volume mounts (
/var/cache/nginx, /var/run) to allow running as non-root, which is required by OpenShift SCCs.
ARC Setup Process (arc-setup.sh):
- Configures the GitHub Actions Runner Controller (ARC) on the cluster.
- Requires
--app-id, --installation-id, and --private-key-file arguments for GitHub App authentication.
- Sets up namespaces (
github-arc, personal-site-pipelines) and installs the controller and runner scale sets using Helm.
To deploy the main application, authenticate to your OKD cluster and run bash infra/okd-setup.sh. To set up CI/CD runners, run bash infra/arc-setup.sh with the required GitHub App credentials.
