30. GitHub 项目配置与密钥管理

# 以 ops 用户身份操作（不切换 root）
sudo dnf install -y git
git --version

# 配置全局身份信息（写入 ~/.gitconfig）
git config --global user.name  "Your Name"
git config --global user.email "your_email@example.com"

# 设置默认主分支为 main（与 GitHub 保持一致）
git config --global init.defaultBranch main

# 设置默认编辑器
git config --global core.editor vim

# Linux 服务器推荐的换行符处理方式
git config --global core.autocrlf input

# 验证配置
git config --list

# 生成专用于 GitHub 的 ed25519 密钥（推荐算法，安全且密钥短）
ssh-keygen -t ed25519 \
  -C "ops@linuxdc-$(date +%Y%m%d)" \
  -f ~/.ssh/id_ed25519_github

# 设置私钥严格权限（SSH 要求私钥权限不超过 600）
chmod 600 ~/.ssh/id_ed25519_github
chmod 644 ~/.ssh/id_ed25519_github.pub

tee -a ~/.ssh/config << 'EOF'

Host github.com
    HostName       github.com
    User           git
    IdentityFile   ~/.ssh/id_ed25519_github
    IdentitiesOnly yes
EOF

chmod 600 ~/.ssh/config

# 查看并复制公钥内容
cat ~/.ssh/id_ed25519_github.pub

ssh -T git@github.com
# 成功输出：Hi <username>! You've successfully authenticated, but GitHub does not provide shell access.

# 在 GitHub 网页端先创建空仓库 linuxdc-ops，然后在本地：
mkdir ~/linuxdc-ops && cd ~/linuxdc-ops
git init

tee README.md << 'EOF'
# linuxdc-ops

企业级 Linux 运维配置管理项目

## 环境信息
- OS: Red Hat Enterprise Linux 9
- 主机: linuxdc (192.168.1.100)
- SSH 端口: 2222
EOF

git add README.md
git commit -m "feat: initial commit"
git remote add origin git@github.com:<your-username>/linuxdc-ops.git
git branch -M main
git push -u origin main

# 前提：已完成 30.3.1–30.3.3 的密钥配置

# 克隆已有仓库
git clone git@github.com:<your-username>/linuxdc-ops.git
cd linuxdc-ops

# 查看远程仓库配置
git remote -v

# 拉取最新代码（确保与远程同步）
git pull origin main

# 查看工作区状态
git status

# 暂存变更（选择性暂存）
git add .                         # 暂存所有变更
git add ansible-playbooks/        # 暂存特定目录

# 提交（使用约定式提交格式，便于生成 CHANGELOG）
git commit -m "feat: add nginx config template"
git commit -m "fix: correct sshd port in ansible playbook"
git commit -m "docs: update README with deployment steps"
git commit -m "chore: clean up temporary scripts"

# 推送到远程仓库
git push origin main

# 创建功能分支（从 main 分出）
git checkout -b feature/add-monitoring

# 开发完成后，切回 main 并合并
git checkout main
git merge feature/add-monitoring

# 删除已合并的本地和远程分支
git branch -d feature/add-monitoring
git push origin --delete feature/add-monitoring

mkdir -p ~/bin

tee ~/bin/git-push.sh << 'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail

if [[ $# -lt 1 ]]; then
    echo "用法: $0 <提交信息>"
    echo "示例: $0 'fix: correct nginx config'"
    exit 1
fi

COMMIT_MSG="$1"
BRANCH=$(git symbolic-ref --short HEAD 2>/dev/null || echo "main")

# 确认当前在 Git 仓库中
git rev-parse --git-dir > /dev/null 2>&1 || {
    echo "错误: 当前目录 $(pwd) 不是 Git 仓库"
    exit 1
}

git add .
git commit -m "${COMMIT_MSG}"
git push origin "${BRANCH}"
echo "已成功推送到 origin/${BRANCH}"
SCRIPT

chmod +x ~/bin/git-push.sh

# 将 ~/bin 加入 PATH（若未添加）
grep -q 'export PATH="$HOME/bin:$PATH"' ~/.bashrc || \
  echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 使用示例
cd ~/linuxdc-ops
git-push.sh "docs: add deployment guide"

设备一（linuxdc 服务器）：
  私钥：~/.ssh/id_ed25519_github
  GitHub 标题：linuxdc-ops-2025

设备二（开发笔记本）：
  私钥：~/.ssh/id_ed25519_github_laptop
  GitHub 标题：laptop-dev-2025

# 第一步：在 GitHub 上删除旧设备的 SSH 密钥
# GitHub → Settings → SSH and GPG keys → 找到旧密钥 → Delete

# 第二步：在旧设备本地安全删除私钥（若仍有操作权限）
shred -u ~/.ssh/id_ed25519_github
shred -u ~/.ssh/id_ed25519_github.pub

# 第三步：验证旧密钥已无法访问 GitHub
ssh -T git@github.com -i /path/to/old-key  # 应提示认证失败

# 配置凭证存储，避免每次输入
git config --global credential.helper store

# PAT 安全使用原则：
# - 设置最小权限范围（仅 repo 读写，不授予 admin 权限）
# - 设置过期时间（建议 90 天或更短）
# - 不同用途使用不同 PAT（运维自动化、个人开发分离）
# - 旧 PAT 立即撤销：
# GitHub → Settings → Developer settings → Personal access tokens → Revoke