ljwx-website/scripts

ljwx-website Deployment Scripts

This directory contains automation scripts for setting up and deploying ljwx-website using GitOps.

Quick Start

Option 1: GitOps Setup (First Time)

Run the complete GitOps setup with one command:

./setup-all.sh

This will guide you through all setup steps interactively (Harbor, GitHub Secrets, Argo CD).

Option 2: Direct Deployment (Quick Deploy)

For direct deployment to K3s without GitOps:

# Interactive mode
./one-click-deploy.sh

# Or quick mode (requires env vars)
export HARBOR_USERNAME="your-username"
export HARBOR_PASSWORD="your-password"
./quick-build-push-deploy.sh

See DEPLOY-README.md for detailed deployment documentation.

Script Categories

🚀 Direct Deployment Scripts (New!)

For quick build-push-deploy to K3s website namespace:

• one-click-deploy.sh - Interactive full deployment with progress display
• quick-build-push-deploy.sh - Fast silent deployment for automation
• env.example - Environment variables template

⚙️ GitOps Setup Scripts

For setting up the GitOps deployment pipeline:

Direct Deployment Scripts Details

one-click-deploy.sh

Purpose: Complete interactive build-push-deploy with detailed progress display.

Features:

• ✅ Interactive UI with colored output
• ✅ Pre-flight checks (Docker, kubectl, K8s)
• ✅ Auto-generated image tags (timestamp + git commit)
• ✅ Harbor login and push
• ✅ K8s deployment with rollout tracking
• ✅ Post-deployment verification
• ✅ Health check testing

Usage:

./one-click-deploy.sh

# Or with environment variables
export HARBOR_USERNAME="your-username"
export HARBOR_PASSWORD="your-password"
./one-click-deploy.sh

What it deploys:

• Namespace: website
• Domain: www.lingjingwanxiang.cn
• Ingress: Traefik with TLS
• Image: harbor.eu.lingjingwanxiang.cn:8080/ljwx/ljwx-website

quick-build-push-deploy.sh

Purpose: Fast non-interactive deployment for automation and CI/CD.

Features:

• ⚡ Minimal output
• ⚡ No interactive prompts
• ⚡ Skip specific steps via env vars
• ⚡ Fast execution

Usage:

# Required environment variables
export HARBOR_USERNAME="your-username"
export HARBOR_PASSWORD="your-password"

# Full deployment
./quick-build-push-deploy.sh

# Only deploy (skip build/push)
SKIP_BUILD=1 SKIP_PUSH=1 ./quick-build-push-deploy.sh

# Only build (skip push/deploy)
SKIP_PUSH=1 SKIP_DEPLOY=1 ./quick-build-push-deploy.sh

Environment variables:

• HARBOR_USERNAME (required) - Harbor username
• HARBOR_PASSWORD (required) - Harbor password
• SKIP_BUILD (optional) - Skip Docker build
• SKIP_PUSH (optional) - Skip Harbor push
• SKIP_DEPLOY (optional) - Skip K8s deployment

env.example

Template for environment variables configuration.

Setup:

# Copy example file
cp env.example env.local

# Edit credentials
nano env.local

# Use it
source env.local
./one-click-deploy.sh

Important: Add env.local to .gitignore - never commit credentials!

---

GitOps Setup Scripts Details

1. setup-harbor.sh

Creates Harbor project and robot account for image storage.

Usage:

HARBOR_ADMIN_PASSWORD='your-password' ./setup-harbor.sh

What it does:

• Creates ljwx project in Harbor (if not exists)
• Creates robot account ljwx-website-deployer with push/pull permissions
• Outputs robot account credentials for GitHub Secrets

Environment variables:

• HARBOR_URL (default: harbor.eu.lingjingwanxiang.cn:8080)
• HARBOR_ADMIN_USER (default: admin)
• HARBOR_ADMIN_PASSWORD (required)

2. setup-github-secrets.sh

Configures GitHub repository secrets for CI/CD.

Prerequisites:

• GitHub CLI (gh) installed and authenticated
• Robot account credentials from Harbor setup

Usage:

./setup-github-secrets.sh

Or with environment variables:

HARBOR_USERNAME='robot$ljwx+deployer' \
HARBOR_PASSWORD='your-robot-token' \
DEPLOY_REPO_TOKEN='ghp_...' \
./setup-github-secrets.sh

Secrets configured:

• HARBOR_USERNAME - Harbor robot account username
• HARBOR_PASSWORD - Harbor robot account password
• DEPLOY_REPO_TOKEN - GitHub PAT for ljwx-deploy repo

Create DEPLOY_REPO_TOKEN:

1. Go to https://github.com/settings/tokens/new
2. Select scopes: repo (Full control of private repositories)
3. Generate and save the token

3. deploy-argocd.sh

Deploys the Argo CD Application to Kubernetes.

Prerequisites:

• kubectl configured with cluster access
• Argo CD installed in cluster
• argocd CLI (optional, for better output)

Usage:

./deploy-argocd.sh

What it does:

• Applies Argo CD Application manifest
• Triggers initial sync
• Displays deployment status

Environment variables:

• ARGOCD_APP_FILE (default: /root/codes/ljwx-deploy/argocd-apps/ljwx-website-eu-dev.yaml)
• NAMESPACE (default: ljwx-website-dev)

4. setup-all.sh

Orchestrates all setup steps in sequence with interactive prompts.

Usage:

./setup-all.sh

Steps:

1. Harbor project setup
2. GitHub secrets configuration
3. Argo CD Application deployment
4. Deployment verification

Deployment Flow

┌─────────────────┐
│  setup-harbor   │  Create Harbor project & robot account
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│ setup-github-   │  Configure GitHub Secrets
│    secrets      │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  deploy-argocd  │  Deploy Argo CD Application
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   Git Push to   │  Trigger CI/CD Pipeline
│   main branch   │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  GitHub Actions │  Build & Push Image to Harbor
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Update         │  Direct commit to ljwx-deploy
│  ljwx-deploy    │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Argo CD Sync   │  Deploy to Kubernetes
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Website Live   │  https://website.lingjingwanxiang.cn
└─────────────────┘

Troubleshooting

Harbor Setup Issues

Error: "Cannot connect to Harbor"

• Check Harbor URL and credentials
• Verify Harbor is accessible: curl -k https://harbor.eu.lingjingwanxiang.cn:8080

Error: "Project already exists"

• This is normal, the script will continue
• Robot account will still be created

GitHub Secrets Issues

Error: "gh: command not found"

# Install GitHub CLI
sudo apt install gh
# or
brew install gh

Error: "Not authenticated"

gh auth login
# Follow prompts to authenticate

Argo CD Deployment Issues

Error: "Argo CD not installed"

# Install Argo CD
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

Application not syncing:

# Check Application status
kubectl get application ljwx-website-eu-dev -n argocd

# View Application details
argocd app get ljwx-website-eu-dev

# Manual sync
argocd app sync ljwx-website-eu-dev

CI/CD Pipeline Issues

Workflow failing on "Build and push":

• Verify GitHub Secrets are set correctly
• Check Harbor credentials: docker login harbor.eu.lingjingwanxiang.cn:8080

Image not updating in cluster:

• Check ljwx-deploy repository was updated by CI
• Verify Argo CD Application is in auto-sync mode
• Force sync: argocd app sync ljwx-website-eu-dev

Verification Commands

# Check Harbor project
curl -k -u admin:password https://harbor.eu.lingjingwanxiang.cn:8080/api/v2.0/projects

# List GitHub Secrets
gh secret list -R BrunoGaoSZ/ljwx-website

# Check Argo CD Application
kubectl get application ljwx-website-eu-dev -n argocd

# View deployment
kubectl get all -n ljwx-website-dev

# Check ingress
kubectl get ingress -n ljwx-website-dev

# View logs
kubectl logs -f deployment/ljwx-website-dev-website -n ljwx-website-dev

Manual Steps (if scripts fail)

Manual Harbor Setup

1. Login to Harbor UI: https://harbor.eu.lingjingwanxiang.cn:8080
2. Create project ljwx (if not exists)
3. Go to Projects → ljwx → Robot Accounts
4. Create robot account with push/pull permissions
5. Save credentials

Manual GitHub Secrets

# Using gh CLI
gh secret set HARBOR_USERNAME -R BrunoGaoSZ/ljwx-website
gh secret set HARBOR_PASSWORD -R BrunoGaoSZ/ljwx-website
gh secret set DEPLOY_REPO_TOKEN -R BrunoGaoSZ/ljwx-website

# Or via GitHub UI
# Settings → Secrets and variables → Actions → New repository secret

Manual Argo CD Deployment

kubectl apply -f /root/codes/ljwx-deploy/argocd-apps/ljwx-website-eu-dev.yaml
argocd app sync ljwx-website-eu-dev

Support

For issues or questions, check:

• Project README: /root/codes/ljwx-website/README.md
• Deployment plan: /root/.claude/plans/parsed-meandering-liskov.md
• GitHub Actions logs: https://github.com/BrunoGaoSZ/ljwx-website/actions