DevOps 도구 및 베스트 프랙티스 마스터 - DevOps 지식 허브 DevOps 도구 및 베스트 프랙티스 마스터 - DevOps 지식 허브

Bash 스크립팅: 종료 코드와 상태에 대한 심층 분석

Bash 종료 코드 이해하기, $? 안전하게 검사하기, exit으로 상태 설정하기, 신뢰할 수 있는 제어 흐름 구축하기.

Bash 스크립팅: 종료 코드와 상태에 대한 심층 분석

Bash 종료 코드는 명령어가 스크립트에 어떤 일이 발생했는지 알려주는 방법입니다. 0은 성공을 의미하고, 0이 아닌 상태는 명령어가 실패했거나 스크립트가 처리해야 할 결과를 생성했음을 의미합니다.

이 가이드에서는 $?를 읽는 방법, exit으로 상태를 설정하는 방법, 그리고 종료 코드를 사용하여 Bash 자동화에서 더 안전한 제어 흐름을 구축하는 방법을 보여줍니다.

종료 코드 이해하기

Bash에서 실행되는 모든 명령어, 함수 또는 스크립트는 완료 시 종료 코드를 반환합니다. 이는 실행 결과를 알리는 정수 값입니다. 관례적으로:

  • 0 (영): 성공을 나타냅니다. 명령어가 오류 없이 완료되었습니다.
  • 0이 아님 (다른 정수): 실패 또는 오류를 나타냅니다. 0이 아닌 값은 특정 유형의 오류를 나타낼 수 있습니다.

이 간단한 0 대 0이 아님 규칙은 Bash가 작동하는 방식과 스크립트에 조건부 논리를 구축할 수 있는 방법의 기본입니다.

마지막 종료 코드 검색: $?

Bash는 $?라는 특수 매개변수를 제공하며, 이는 가장 최근에 실행된 포그라운드 명령어의 종료 코드를 보유합니다. 명령어 직후에 값을 확인하여 결과를 확인할 수 있습니다.

# 예제 1: 성공적인 명령어
ls /tmp
echo "'ls /tmp'의 종료 코드: $?"

# 예제 2: 실패한 명령어 (존재하지 않는 디렉토리)
ls /nonexistent_directory
echo "'ls /nonexistent_directory'의 종료 코드: $?"

# 예제 3: 일치하는 항목을 찾은 Grep (성공)
grep "root" /etc/passwd
echo "'grep root /etc/passwd'의 종료 코드: $?"

# 예제 4: 일치하는 항목을 찾지 못한 Grep (실패, 그러나 예상됨)
grep "nonexistent_user" /etc/passwd
echo "'grep nonexistent_user /etc/passwd'의 종료 코드: $?"

출력 (시스템 및 /etc/passwd 내용에 따라 약간 다를 수 있음):

ls /tmp
# ... (/tmp의 파일 목록)
'ls /tmp'의 종료 코드: 0
ls /nonexistent_directory
ls: '/nonexistent_directory'에 접근할 수 없음: 그런 파일이나 디렉토리가 없습니다
'ls /nonexistent_directory'의 종료 코드: 2
grep "root" /etc/passwd
root:x:0:0:root:/root:/bin/bash
'grep root /etc/passwd'의 종료 코드: 0
grep "nonexistent_user" /etc/passwd
'grep nonexistent_user /etc/passwd'의 종료 코드: 1

grep은 일치 시 0을 반환하고 일치하지 않으면 1을 반환합니다. 둘 다 grep의 맥락에서 유효한 결과이지만, 조건부 논리의 경우 0은 패턴의 성공적인 발견을 의미합니다.

exit으로 종료 코드 명시적으로 설정하기

자체 스크립트나 함수를 작성할 때 exit 명령어 뒤에 정수 값을 사용하여 종료 코드를 명시적으로 설정할 수 있습니다. 이는 호출 프로세스, 상위 스크립트 또는 CI/CD 파이프라인에 스크립트 결과를 전달하는 데 중요합니다.

#!/bin/bash

# script_success.sh
echo "이 스크립트는 성공(0)으로 종료됩니다"
exit 0

#!/bin/bash

# script_failure.sh
echo "이 스크립트는 실패(1)로 종료됩니다"
exit 1

# 스크립트 테스트
./script_success.sh
echo "script_success.sh의 상태: $?"

./script_failure.sh
echo "script_failure.sh의 상태: $?"

출력:

이 스크립트는 성공(0)으로 종료됩니다
script_success.sh의 상태: 0
이 스크립트는 실패(1)로 종료됩니다
script_failure.sh의 상태: 1

팁: exit이 인수 없이 호출되면 스크립트의 종료 상태는 exit이 호출되기 전에 마지막으로 실행된 명령어의 종료 상태가 됩니다.

제어 흐름을 위한 종료 코드 활용

종료 코드는 Bash에서 조건부 실행의 중추이며, 동적이고 반응적인 스크립트를 만들 수 있게 해줍니다.

조건문 (if/else)

Bash의 if 문은 명령어의 종료 코드를 평가합니다. 명령어가 0(성공)으로 종료되면 if 블록이 실행됩니다. 그렇지 않으면 else 블록(있는 경우)이 실행됩니다.

#!/bin/bash

FILE="/path/to/my/important_file.txt"

if [ -f "$FILE" ]; then # 테스트 명령어 `[`는 파일이 존재하면 0으로 종료
    echo "파일 '$FILE'이(가) 존재합니다. 처리 진행 중..."
    # 파일 처리 로직 추가
    # 예: cat "$FILE"
    exit 0
else
    echo "오류: 파일 '$FILE'이(가) 존재하지 않습니다."
    echo "스크립트를 중단합니다."
    exit 1
fi

논리 연산자 (&&, ||)

Bash는 종료 코드에 의존하는 강력한 단축 평가 논리 연산자를 제공합니다:

  • command1 && command2: command1이 0(성공)으로 종료된 경우에만 command2가 실행됩니다.
  • command1 || command2: command1이 0이 아닌 값(실패)으로 종료된 경우에만 command2가 실행됩니다.

이는 순차적 명령어와 대체 메커니즘에 매우 유용합니다.

#!/bin/bash

LOG_DIR="/var/log/my_app"

# 디렉토리가 없을 경우에만 생성
mkdir -p "$LOG_DIR" && echo "로그 디렉토리 '$LOG_DIR'이(가) 확인되었습니다."

# 서비스 시작 시도, 실패하면 대체 명령어 실행
systemctl start my_service || { echo "my_service 시작 실패. 대체 시도 중..."; ./start_fallback.sh; }

# 스크립트가 계속되기 위해 반드시 성공해야 하는 명령어
copy_data_to_backup_location && echo "데이터 백업 성공." || { echo "데이터 백업 실패!"; exit 1; }

echo "스크립트가 성공적으로 완료되었습니다."
exit 0

set -e: 오류 시 종료

set -e 옵션은 스크립트를 더 강력하게 만드는 강력한 도구입니다. set -e가 활성화되면 명령어가 0이 아닌 상태로 종료될 때 Bash가 즉시 스크립트를 종료합니다. 이는 조용한 실패와 연쇄 오류를 방지합니다.

#!/bin/bash
set -e # 명령어가 0이 아닌 상태로 종료되면 즉시 종료

echo "스크립트 시작..."

# 이 명령어는 성공합니다
ls /tmp

echo "첫 번째 명령어 성공."

# 이 명령어는 실패하며, 'set -e'로 인해 스크립트가 여기서 종료됩니다
ls /nonexistent_path

echo "이전 명령어가 실패하면 이 줄은 절대 도달하지 않습니다."

exit 0 # 이 줄은 모든 이전 명령어가 성공한 경우에만 도달합니다

출력 (/nonexistent_path가 존재하지 않는 경우):

스크립트 시작...
# ... (ls /tmp의 출력)
첫 번째 명령어 성공.
ls: '/nonexistent_path'에 접근할 수 없음: 그런 파일이나 디렉토리가 없습니다

스크립트는 실패한 ls 명령어 후에 종료되며, "이 줄은 절대 도달하지 않습니다" 메시지는 출력되지 않습니다.

경고: set -e에는 예외가 있으며, 일부 명령어는 예상된 결과에 대해 0이 아닌 값을 반환합니다. 예를 들어, grep은 일치하는 항목이 없을 때 1을 반환합니다. 결과가 중요한 경우 명시적인 if grep -q "pattern" file; then ... fi를 선호하세요.

일반적인 종료 코드 시나리오 및 모범 사례

성공의 경우 0, 실패의 경우 0이 아님이 일반적인 규칙이지만, 일부 0이 아닌 코드는 특히 시스템 명령어와 내장 명령어에 대해 일반적인 의미를 갖습니다:

  • 0: 성공.
  • 1: 일반 오류, 다양한 문제에 대한 포괄적 오류.
  • 2: 셸 내장 명령어의 잘못된 사용 또는 잘못된 명령어 인수.
  • 126: 호출된 명령어를 실행할 수 없음 (예: 권한 문제, 실행 파일이 아님).
  • 127: 명령어를 찾을 수 없음 (예: 명령어 이름 오타, PATH에 없음).
  • 128 + N: 명령어가 신호 N에 의해 종료되었습니다. 예를 들어, 130 (128 + 2)은 명령어가 SIGINT (Ctrl+C)에 의해 종료되었음을 의미합니다.

자체 스크립트를 만들 때는 성공에 0을 사용하세요. 실패의 경우 1이 일반 오류에 대한 안전한 기본값입니다. 스크립트가 여러 개의 다른 오류 조건을 처리하는 경우 더 높은 0이 아닌 값(예: 10, 20, 30)을 사용하여 구분할 수 있지만, 이러한 사용자 정의 코드를 명확하게 문서화하세요.

강력한 스크립팅을 위한 모범 사례:

  1. 중요한 명령어 항상 확인: 성공을 가정하지 마세요. if 문이나 &&를 사용하여 중요한 단계를 확인하세요.
  2. 정보를 제공하는 오류 메시지 제공: 스크립트가 실패하면 stderr에 무엇이 잘못되었는지와 어떻게 잠재적으로 수정할 수 있는지 설명하는 명확한 메시지를 출력하세요. 표준 오류로 출력을 리디렉션하려면 >&2를 사용하세요.
    my_command || { echo "오류: my_command 실패. 로그를 확인하세요." >&2; exit 1; }
  3. 실패 시 정리: trap을 사용하여 스크립트가 조기에 종료되더라도 임시 파일이나 리소스가 정리되도록 보장하세요.
    cleanup() {
    echo "임시 파일 정리 중..."
    rm -f /tmp/my_temp_file_$$
}
trap cleanup EXIT
  4. 입력 유효성 검사: 스크립트 인수나 환경 변수를 일찍 확인하고 유효하지 않은 경우 정보를 제공하는 오류와 함께 종료하세요.
  5. 종료 상태 기록: 복잡한 자동화의 경우 감사 및 디버깅 목적으로 주요 작업의 종료 상태를 기록하세요.

실제 예제: 강력한 백업 스크립트 스니펫

다음은 실제 시나리오에서 이러한 개념을 결합하는 방법입니다:

#!/bin/bash
set -e # 명령어가 0이 아닌 상태로 종료되면 즉시 종료

BACKUP_SOURCE="/data/app/config"
BACKUP_DEST="/mnt/backup/configs"
TIMESTAMP=$(date +%Y%m%d%H%M%S)
LOG_FILE="/var/log/backup_config_${TIMESTAMP}.log"

# --- 함수 ---
log_message() {
    echo "$(date +%Y-%m-%d_%H:%M:%S) - $1" | tee -a "$LOG_FILE"
}

cleanup() {
    log_message "정리 시작."
    if [ -n "${TEMP_DIR:-}" ] && [ -d "$TEMP_DIR" ]; then
        rm -rf "$TEMP_DIR"
        log_message "임시 디렉토리 제거됨: $TEMP_DIR"
    fi
}

# --- 종료 및 신호에 대한 트랩 ---
trap 'cleanup' EXIT
trap 'log_message "스크립트 중단됨 (SIGINT). 종료합니다."; exit 130' INT
trap 'log_message "스크립트 종료됨 (SIGTERM). 종료합니다."; exit 143' TERM

# --- 메인 스크립트 로직 ---
log_message "구성 백업 시작."

# 1. 소스 디렉토리 존재 확인
if [ ! -d "$BACKUP_SOURCE" ]; then
    log_message "오류: 백업 소스 '$BACKUP_SOURCE'이(가) 존재하지 않습니다." >&2
    exit 2 # 잘못된 소스에 대한 사용자 정의 오류 코드
fi

# 2. 백업 대상 존재 확인
mkdir -p "$BACKUP_DEST" || {
    log_message "오류: 백업 대상 '$BACKUP_DEST'을(를) 생성/확인하지 못했습니다." >&2
    exit 3 # 대상 문제에 대한 사용자 정의 오류 코드
}

# 3. 압축을 위한 임시 디렉토리 생성
TEMP_DIR=$(mktemp -d)
log_message "임시 디렉토리 생성됨: $TEMP_DIR"

# 4. 임시 디렉토리로 데이터 복사
cp -r "$BACKUP_SOURCE" "$TEMP_DIR/" || {
    log_message "오류: '$BACKUP_SOURCE'에서 '$TEMP_DIR'로 데이터 복사 실패." >&2
    exit 4 # 복사 실패에 대한 사용자 정의 오류 코드
}
log_message "데이터가 임시 위치로 복사되었습니다."

# 5. 데이터 압축
ARCHIVE_NAME="config_backup_${TIMESTAMP}.tar.gz"
tar -czf "$TEMP_DIR/$ARCHIVE_NAME" -C "$TEMP_DIR" "$(basename "$BACKUP_SOURCE")" || {
    log_message "오류: 데이터 압축 실패." >&2
    exit 5 # 압축 실패에 대한 사용자 정의 오류 코드
}
log_message "데이터가 $ARCHIVE_NAME으로 압축되었습니다."

# 6. 최종 대상으로 아카이브 이동
mv "$TEMP_DIR/$ARCHIVE_NAME" "$BACKUP_DEST/" || {
    log_message "오류: 아카이브를 '$BACKUP_DEST'로 이동하지 못했습니다." >&2
    exit 6 # 이동 실패에 대한 사용자 정의 오류 코드
}
log_message "아카이브가 '$BACKUP_DEST/$ARCHIVE_NAME'으로 이동되었습니다."

log_message "백업이 성공적으로 완료되었습니다!"
exit 0

핵심 요약

종료 코드를 스크립트 인터페이스의 일부로 취급하세요. 중요한 명령어를 확인하고, 실패 시 명확한 0이 아닌 상태를 반환하며, 다른 스크립트나 CI 작업이 해석해야 할 수 있는 사용자 정의 코드를 문서화하세요.