ssh -i your-key.pem ubuntu@<EC2-PUBLIC-IP>

#!/bin/bash
# Quick GitHub Actions Runner Setup Script
# Run this on your EC2 instance
 
set -e
 
echo "========================================="
echo "GitHub Actions Runner Quick Setup"
echo "========================================="
 
# Update system
echo "📦 Updating system packages..."
sudo apt update && sudo apt upgrade -y
 
# Install essential tools
echo "🔧 Installing essential tools..."
sudo apt install -y curl wget git jq unzip build-essential
 
# Install Docker
echo "🐳 Installing Docker..."
sudo apt install -y docker.io
sudo usermod -aG docker ubuntu
sudo systemctl enable docker
sudo systemctl start docker
 
# Install Docker Compose
echo "📦 Installing Docker Compose..."
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
 
# Install PostgreSQL client
echo "🐘 Installing PostgreSQL client..."
sudo apt install -y postgresql-client
 
# Install MySQL client
echo "🐬 Installing MySQL client..."
sudo apt install -y mysql-client
 
# Install AWS CLI
echo "☁️  Installing AWS CLI..."
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
rm -rf aws awscliv2.zip
 
# Install Node.js 20
echo "📗 Installing Node.js..."
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
 
# Install Python and pip
echo "🐍 Installing Python..."
sudo apt install -y python3 python3-pip python3-venv
 
# Download GitHub Actions Runner
echo "🏃 Downloading GitHub Actions Runner..."
mkdir -p ~/actions-runner && cd ~/actions-runner
 
# Get latest runner version
RUNNER_VERSION=$(curl -s https://api.github.com/repos/actions/runner/releases/latest | jq -r '.tag_name' | sed 's/v//')
echo "Latest runner version: $RUNNER_VERSION"
 
curl -o actions-runner-linux-x64-${RUNNER_VERSION}.tar.gz -L \
  "https://github.com/actions/runner/releases/download/v${RUNNER_VERSION}/actions-runner-linux-x64-${RUNNER_VERSION}.tar.gz"
 
# Extract
tar xzf ./actions-runner-linux-x64-${RUNNER_VERSION}.tar.gz
rm actions-runner-linux-x64-${RUNNER_VERSION}.tar.gz
 
echo ""
echo "========================================="
echo "✅ Installation Complete!"
echo "========================================="
echo ""
echo "Installed versions:"
docker --version
docker-compose --version
psql --version
mysql --version
aws --version
node --version
python3 --version
echo ""
echo "========================================="
echo "📝 NEXT STEPS:"
echo "========================================="
echo ""
echo "1. Get your GitHub runner token:"
echo "   - Go to: https://github.com/YOUR_ORG/YOUR_REPO/settings/actions/runners/new"
echo "   - Copy the token"
echo ""
echo "2. Configure the runner:"
echo "   cd ~/actions-runner"
echo "   ./config.sh --url https://github.com/YOUR_ORG/YOUR_REPO --token YOUR_TOKEN"
echo ""
echo "3. Install as a service:"
echo "   sudo ./svc.sh install"
echo "   sudo ./svc.sh start"
echo ""
echo "4. For Docker commands to work without sudo, logout and login again"
echo ""
echo "========================================="

# Download and run the setup script
curl -sSL https://gist.githubusercontent.com/YOUR_GIST/setup-runner.sh | bash

chmod +x setup-runner.sh
./setup-runner.sh

cd ~/actions-runner
 
# Configure (replace with your values)
./config.sh \
  --url https://github.com/YOUR_ORG/YOUR_REPO \
  --token YOUR_COPIED_TOKEN \
  --name aws-runner-1 \
  --labels self-hosted,linux,x64,production,vpc \
  --work _work \
  --unattended
 
# You should see:
# ✓ Runner successfully added
# ✓ Runner connection is good

# Install service
sudo ./svc.sh install
 
# Start service
sudo ./svc.sh start
 
# Check status
sudo ./svc.sh status
 
# Should show: "Active: active (running)"

sudo systemctl enable actions.runner.*.service

# Test PostgreSQL connection
PGPASSWORD='your_password' psql \
  -h your-rds-host.rds.amazonaws.com \
  -p 5432 \
  -U your_username \
  -d your_database \
  -c "SELECT version();"
 
# If successful, you'll see PostgreSQL version info

# Check network connectivity
nc -zv your-rds-host.rds.amazonaws.com 5432
 
# If timeout, check:
# 1. RDS Security Group allows EC2 Security Group
# 2. EC2 is in same VPC as RDS

# .github/workflows/quick-test.yml
name: Quick Test Runner
 
on:
  workflow_dispatch:
  push:
    branches: [main]
 
jobs:
  test:
    runs-on: [self-hosted, linux, production]
    
    steps:
      - name: Test runner
        run: |
          echo "✅ Runner working!"
          echo "Runner: $RUNNER_NAME"
          echo "OS: $RUNNER_OS"
          hostname
      
      - name: Test database
        env:
          PGPASSWORD: ${{ secrets.DB_PASSWORD }}
        run: |
          psql \
            -h ${{ secrets.RDS_HOST }} \
            -p ${{ secrets.RDS_PORT }} \
            -U ${{ secrets.DB_USER }} \
            -d ${{ secrets.DB_NAME }} \
            -c "SELECT 'Connected!' as status, NOW() as time;"

# On your local machine
scp -i your-key.pem setup-runner.sh ubuntu@<EC2-IP>:~/
 
# SSH to EC2
ssh -i your-key.pem ubuntu@<EC2-IP>
 
# Run setup
chmod +x setup-runner.sh
./setup-runner.sh YOUR_GITHUB_TOKEN https://github.com/YOUR_ORG/YOUR_REPO

# Check service status
sudo systemctl status actions.runner.*.service
 
# View logs
sudo journalctl -u actions.runner.*.service -f
 
# Restart
sudo ./svc.sh restart

# Test connectivity
nc -zv your-rds-host.rds.amazonaws.com 5432
 
# Check route
traceroute your-rds-host.rds.amazonaws.com
 
# Verify security groups in AWS console

# Logout and login again
exit
ssh -i your-key.pem ubuntu@<EC2-IP>
 
# Or force group reload
newgrp docker

# Check runner status
sudo systemctl status actions.runner.*.service
 
# View runner logs
sudo journalctl -u actions.runner.*.service -f
 
# Restart runner
cd ~/actions-runner
sudo ./svc.sh restart
 
# Stop runner
sudo ./svc.sh stop
 
# Start runner
sudo ./svc.sh start
 
# Remove runner
sudo ./svc.sh stop
./config.sh remove --token YOUR_TOKEN