[Infra Ops] 실무 백엔드 자동화를 위한 Bash 쉘 스크립트 작성 기법

[셸]  cp "$SRC"/*.war "$DST"
   │
   ① 읽기·라인 분리        (스크립트를 줄 단위로 읽어 명령을 구성)
   │
   ② 파싱·토큰화           (단어·연산자 분리, 인용부호 해석)
   │
   ③ 확장(정해진 순서)      (중괄호 → 틸드 → 변수·명령치환·산술 → 단어분리 → 글롭)
   │    → 이 시점에 "$SRC"가 실제 경로로, *.war가 실제 파일 목록으로 바뀜
   │
   ④ 명령 실행            (PATH에서 cp를 찾아 확장된 인자로 실행)
   │
   ⑤ 종료코드 전파         ($?에 결과 저장 → set -e·|| 가 이 값으로 판단)
   ▼
[셸]  다음 줄로 (set -e면 0이 아닐 때 여기서 종료)

#!/usr/bin/env bash
# 파일명: deploy-app.sh
# 설명: 애플리케이션 배포 스크립트

# --- 안전장치 ---
set -e              # 명령어 실패 시 즉시 종료
set -o pipefail     # 파이프라인 중간 실패도 감지
set -u              # 정의되지 않은 변수 사용 시 오류

# --- 상수 정의 ---
readonly SCRIPT_NAME="$(basename "$0")"
readonly LOG_TAG="deploy"
readonly TIMESTAMP="$(date +%Y%m%d_%H%M%S)"

# --- 함수 정의 ---
log() {
  echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*"
  logger -t "$LOG_TAG" "$*"    # syslog에도 기록
}

error() {
  echo "[ERROR] $*" >&2
  logger -t "$LOG_TAG" "ERROR: $*"
  exit 1
}

# --- 트랩 설정 (스크립트 종료 시 항상 실행) ---
cleanup() {
  local exit_code=$?
  if [[ $exit_code -ne 0 ]]; then
    log "Script failed with exit code $exit_code"
  fi
}
trap cleanup EXIT

# --- 인자 검증 ---
if [[ $# -lt 1 ]]; then
  error "Usage: $SCRIPT_NAME <war_file>"
fi

WAR_FILE="$1"

if [[ ! -f "$WAR_FILE" ]]; then
  error "File not found: $WAR_FILE"
fi

log "Starting deployment: $WAR_FILE"
# ... 실제 작업
log "Deployment completed"

# 변수 선언 (따옴표 항상 사용)
APP_DIR="/opt/tomcat"
APP_NAME="myapp"
MAX_RETRY=3

# 인자 처리
SCRIPT_NAME="$0"    # 스크립트 이름
ARG1="$1"           # 첫 번째 인자
ARG2="${2:-default}" # 두 번째 인자 (없으면 "default")
ARG_COUNT="$#"      # 인자 개수

# 명령어 출력을 변수에 저장
CURRENT_DATE=$(date +%Y%m%d)
DISK_USAGE=$(df -h / | awk 'NR==2 {print $5}' | tr -d '%')

echo "오늘 날짜: $CURRENT_DATE, 디스크 사용: ${DISK_USAGE}%"

# 파일/디렉터리 존재 확인
if [[ -f "/opt/app/config.yml" ]]; then
  echo "설정 파일 존재"
elif [[ -d "/opt/app" ]]; then
  echo "디렉터리만 존재"
else
  echo "경로 없음"
fi

# 변수 비어있는지 확인
if [[ -z "$WAR_FILE" ]]; then
  error "WAR_FILE이 비어있습니다"
fi

# 숫자 비교
if [[ "$DISK_USAGE" -ge 85 ]]; then
  echo "경고: 디스크 사용률 ${DISK_USAGE}%"
fi

# 문자열 비교
if [[ "$ENV" == "production" ]]; then
  echo "운영 환경"
fi

# 명령어 성공/실패 확인 (set -e 없이 수동 처리)
if systemctl is-active --quiet nginx; then
  echo "nginx 실행 중"
else
  echo "nginx 중지됨"
fi

# for 반복문
for server in web01 web02 was01 was02; do
  echo "점검 중: $server"
  ssh "$server" "uptime && df -h / | tail -1"
done

# 파일 목록 반복
for war_file in /tmp/*.war; do
  [[ -f "$war_file" ]] || continue    # 파일 없으면 건너뜀
  echo "처리: $war_file"
done

# while + read (파일에서 서버 목록 읽기)
while IFS= read -r server; do
  [[ -z "$server" || "$server" =~ ^# ]] && continue  # 빈 줄, 주석 건너뜀
  echo "접속: $server"
  ssh -o ConnectTimeout=5 "$server" "hostname"
done < /etc/server-list.txt

# C-style for (카운터)
for ((i=1; i<=3; i++)); do
  echo "시도 $i/3"
  curl -sf http://localhost:8080/health && break
  sleep 5
done

#!/usr/bin/env bash
# disk-check.sh — 디스크 사용률 점검 및 알림

set -euo pipefail

readonly THRESHOLD=85    # 경고 기준 (%)
readonly CRITICAL=95     # 위험 기준 (%)
readonly LOG_TAG="disk-check"
readonly HOSTNAME=$(hostname)

log() { logger -t "$LOG_TAG" "$*"; echo "[$(date '+%H:%M:%S')] $*"; }

check_disk() {
  local mount_point="$1"
  local usage

  usage=$(df -h "$mount_point" | awk 'NR==2 {print $5}' | tr -d '%')

  if [[ "$usage" -ge "$CRITICAL" ]]; then
    log "CRITICAL: $HOSTNAME $mount_point 디스크 ${usage}% — 즉시 조치 필요"
    # 실제 환경: curl -X POST $SLACK_WEBHOOK -d '{"text":"..."}'
    return 1
  elif [[ "$usage" -ge "$THRESHOLD" ]]; then
    log "WARNING: $HOSTNAME $mount_point 디스크 ${usage}%"
    return 0
  else
    log "OK: $mount_point ${usage}%"
    return 0
  fi
}

# inode 사용률도 함께 체크
check_inode() {
  local mount_point="$1"
  local inode_usage

  inode_usage=$(df -i "$mount_point" | awk 'NR==2 {print $5}' | tr -d '%')

  if [[ "$inode_usage" -ge "$THRESHOLD" ]]; then
    log "WARNING: $HOSTNAME $mount_point inode ${inode_usage}%"
  fi
}

# 점검할 마운트 포인트 목록
MOUNT_POINTS=("/" "/var" "/opt" "/data")

exit_code=0
for mp in "${MOUNT_POINTS[@]}"; do
  # 마운트 포인트가 존재하는지 확인
  mountpoint -q "$mp" 2>/dev/null || continue
  check_disk "$mp" || exit_code=1
  check_inode "$mp"
done

exit $exit_code

# crontab에 등록 (매 10분마다 실행)
# crontab -e
*/10 * * * * /opt/scripts/disk-check.sh >> /var/log/disk-check.log 2>&1

#!/usr/bin/env bash
# deploy-war.sh — Tomcat WAR 파일 배포 스크립트
# 사용: ./deploy-war.sh /tmp/myapp-1.2.3.war [서버명]

set -euo pipefail

# --- 설정 ---
readonly TOMCAT_DIR="/opt/tomcat"
readonly WEBAPPS_DIR="$TOMCAT_DIR/webapps"
readonly BACKUP_DIR="$TOMCAT_DIR/webapps-backup"
readonly TOMCAT_SERVICE="tomcat"
readonly TOMCAT_USER="tomcat"
readonly LOG_TAG="deploy-war"
readonly TIMESTAMP=$(date +%Y%m%d_%H%M%S)

log()   { echo "[$(date '+%H:%M:%S')] $*"; logger -t "$LOG_TAG" "$*"; }
error() { echo "[ERROR] $*" >&2; logger -t "$LOG_TAG" "ERROR: $*"; exit 1; }

# 인자 검증
[[ $# -ge 1 ]] || error "Usage: $(basename $0) <war_file>"
WAR_FILE="$1"
[[ -f "$WAR_FILE" ]] || error "WAR 파일 없음: $WAR_FILE"

APP_NAME=$(basename "$WAR_FILE" .war)  # myapp-1.2.3
log "배포 시작: $APP_NAME"

# 1. 사전 백업
mkdir -p "$BACKUP_DIR"
if [[ -d "$WEBAPPS_DIR/$APP_NAME" ]]; then
  tar -czf "$BACKUP_DIR/${APP_NAME}_${TIMESTAMP}.tar.gz" \
    -C "$WEBAPPS_DIR" "$APP_NAME"
  log "기존 버전 백업: ${APP_NAME}_${TIMESTAMP}.tar.gz"
fi
if [[ -f "$WEBAPPS_DIR/${APP_NAME}.war" ]]; then
  cp "$WEBAPPS_DIR/${APP_NAME}.war" \
     "$BACKUP_DIR/${APP_NAME}.war.${TIMESTAMP}"
fi

# 2. Tomcat 중지
log "Tomcat 중지 중..."
sudo systemctl stop "$TOMCAT_SERVICE"

# 중지 확인 (최대 30초 대기)
for i in $(seq 1 30); do
  if ! systemctl is-active --quiet "$TOMCAT_SERVICE"; then
    break
  fi
  sleep 1
done
systemctl is-active --quiet "$TOMCAT_SERVICE" && error "Tomcat 중지 실패"

# 3. 기존 배포 디렉터리 삭제 (war 파일 자동 압축 해제 방지)
TARGET_DIR="${WEBAPPS_DIR}/${APP_NAME}"
case "$TARGET_DIR" in
  /opt/tomcat/webapps/*) ;;
  *) error "허용되지 않은 배포 경로: $TARGET_DIR" ;;
esac
test -n "$APP_NAME" && test "$APP_NAME" != "ROOT" || error "APP_NAME 확인 필요"
test "$(readlink -f "$TARGET_DIR")" = "$TARGET_DIR" || error "심볼릭 링크/경로 검증 실패"
test -d "$TARGET_DIR" && rm -rf -- "$TARGET_DIR"
rm -f "$WEBAPPS_DIR/${APP_NAME}.war"

# 4. WAR 파일 복사 및 권한 설정
log "WAR 파일 배포 중..."
cp "$WAR_FILE" "$WEBAPPS_DIR/"
chown "${TOMCAT_USER}:${TOMCAT_USER}" "$WEBAPPS_DIR/${APP_NAME}.war"
chmod 644 "$WEBAPPS_DIR/${APP_NAME}.war"

# 5. Tomcat 시작
log "Tomcat 시작 중..."
sudo systemctl start "$TOMCAT_SERVICE"

# 6. 기동 확인 (최대 60초 대기)
log "서비스 기동 확인 중..."
for i in $(seq 1 60); do
  if curl -sf http://localhost:8080/${APP_NAME}/health > /dev/null 2>&1; then
    log "배포 완료! ($i초 소요)"
    logger -t "$LOG_TAG" "SUCCESS: $APP_NAME deployed in ${i}s"
    exit 0
  fi
  sleep 1
done

# 7. 기동 실패 → 자동 롤백
error "서비스 기동 실패 — 롤백을 수동으로 수행하세요: $BACKUP_DIR"

#!/usr/bin/env bash
# service-check.sh — 다중 서버 서비스 상태 일괄 점검

set -euo pipefail

# --- 설정 ---
readonly SERVER_LIST="/etc/infra/was-servers.txt"  # 서버 목록 파일
readonly SSH_OPTS="-o ConnectTimeout=5 -o StrictHostKeyChecking=yes -o BatchMode=yes"
readonly LOG_TAG="service-check"

log() { logger -t "$LOG_TAG" "$*"; }

# 단일 서버 점검 함수
check_server() {
  local server="$1"
  local result=""
  local status="OK"

  # SSH로 원격 점검 명령 실행
  result=$(ssh $SSH_OPTS "$server" '
    # 서비스 상태
    TOMCAT=$(systemctl is-active tomcat 2>/dev/null || echo "unknown")
    NGINX=$(systemctl is-active nginx 2>/dev/null || echo "not-installed")

    # 헬스체크 URL 응답
    HEALTH=$(curl -sf -o /dev/null -w "%{http_code}" http://localhost:8080/health 2>/dev/null || echo "fail")

    # 리소스 상태
    DISK=$(df -h / | awk "NR==2{print \$5}")
    MEM_AVAIL=$(free -m | awk "NR==2{print \$7}")
    LOAD=$(uptime | awk -F"average:" "{print \$2}" | awk "{print \$1}" | tr -d ",")

    echo "tomcat=${TOMCAT} nginx=${NGINX} health=${HEALTH} disk=${DISK} mem_avail=${MEM_AVAIL}MB load=${LOAD}"
  ' 2>/dev/null || echo "SSH_FAILED")

  # 결과 파싱 및 이상 여부 판단
  if [[ "$result" == "SSH_FAILED" ]]; then
    status="SSH_FAIL"
  elif echo "$result" | grep -q "tomcat=failed\|tomcat=inactive"; then
    status="TOMCAT_DOWN"
  elif echo "$result" | grep -q "health=fail\|health=503\|health=502"; then
    status="HEALTH_FAIL"
  fi

  printf "%-15s %-10s %s\n" "$server" "[$status]" "$result"
  log "$server $status: $result"
}

# 서버 목록 파일 생성 (없는 경우 예시)
if [[ ! -f "$SERVER_LIST" ]]; then
  echo "서버 목록 파일 없음: $SERVER_LIST"
  echo "예시 파일 형식:"
  echo "  10.0.1.11  # was01-prd"
  echo "  10.0.1.12  # was02-prd"
  exit 0
fi

echo "=================================================="
echo " 서비스 기동 상태 점검 — $(date '+%Y-%m-%d %H:%M:%S')"
echo "=================================================="
printf "%-15s %-10s %s\n" "SERVER" "STATUS" "DETAIL"
echo "--------------------------------------------------"

FAIL_COUNT=0
while IFS= read -r line; do
  # 빈 줄, 주석 건너뜀
  [[ -z "$line" || "$line" =~ ^[[:space:]]*# ]] && continue

  server=$(echo "$line" | awk '{print $1}')
  result_line=$(check_server "$server")
  echo "$result_line"

  echo "$result_line" | grep -qv '\[OK\]' && ((FAIL_COUNT++)) || true
done < "$SERVER_LIST"

echo "=================================================="
echo "점검 완료: 이상 서버 ${FAIL_COUNT}대"
log "점검 완료: 이상 ${FAIL_COUNT}대"

[[ "$FAIL_COUNT" -gt 0 ]] && exit 1 || exit 0

# 사용법
chmod +x ~/scripts/service-check.sh

# 직접 실행
~/scripts/service-check.sh

# crontab — 매 5분마다 실행
*/5 * * * * /opt/scripts/service-check.sh >> /var/log/service-check.log 2>&1