====== Automail.sh: 자동화 실행 래퍼 스크립트 ======

''Automail.sh''는 ''NewstoHR.py'' 파이썬 스크립트를 **[[wiki:glossary:server_operations:linux|Linux]] 서버 환경**에서 안정적으로 자동 실행하기 위해 만들어진 셸 스크립트입니다. 이 스크립트는 단순히 파이썬 스크립트를 호출하는 것을 넘어, 자동화된 작업 환경에서 발생할 수 있는 다양한 문제들을 사전에 방지하고, 실행의 안정성과 신뢰성을 확보하기 위한 핵심적인 ''래퍼(Wrapper)'' 역할을 수행합니다. 주로 ''crontab''과 같은 시스템 스케줄러에 등록되어 사용되며, 파이썬 코드가 실행되기 전 필요한 모든 사전 작업을 체계적으로 처리하고, 실행 후 결과를 기록하여 모니터링을 용이하게 합니다.

===== 1. 주요 기능 및 실행 순서 =====
----
==== 1) 실행 경로 설정 ====
스크립트의 가장 첫 부분에서 ''cd "$(dirname "$0")"'' 명령과 ''BASE_DIR=$(cd "$(dirname "$0")" && pwd)'' 구문을 사용하여 스크립트가 실행되는 현재 디렉토리를 기준으로 작업 경로를 설정합니다.
  *   **경로 이동의 중요성**: ''crontab''과 같은 스케줄러는 스크립트를 실행할 때 특정 작업 디렉토리가 아닌 임의의 위치에서 실행할 수 있습니다. 이로 인해 스크립트 내에서 상대 경로로 파일을 참조할 경우 ''파일을 찾을 수 없음'' 오류가 발생할 수 있습니다.
  *   **오류 방지**: ''Automail.sh'' 스크립트가 어떤 위치에서 실행되더라도, 항상 스크립트 파일이 위치한 디렉토리로 먼저 이동함으로써, 파이썬 스크립트나 기타 리소스 파일의 절대 경로를 명시할 필요 없이 상대 경로 참조가 가능해집니다. 이는 경로 관련 오류를 원천적으로 방지하고 스크립트의 이식성을 높입니다.
  *   **''BASE_DIR'' 변수**: 설정된 기본 경로를 ''BASE_DIR'' 변수에 저장하여, 스크립트 내 다른 부분에서 이 경로를 필요로 할 때 쉽게 재활용할 수 있도록 합니다.

----
==== 2) 로그 기록 시작 ====
스크립트의 시작을 알리는 로그를 지정된 로그 파일(''cron.log'')에 기록합니다.
  *   **로그의 목적**: 자동화된 스크립트는 사용자 인터페이스가 없으므로, 실행 상태와 결과를 확인하기 위한 로그 기록이 필수적입니다. 이 시작 로그는 스크립트가 언제 실행되었는지에 대한 명확한 시간 정보를 제공합니다.
  *   **시간 정보 포함**: ''date'' 명령을 사용하여 현재 시간을 포함시켜, 나중에 로그를 분석할 때 특정 시점의 실행 기록을 쉽게 추적할 수 있도록 합니다.
  *   **로그 파일 명명**: 일반적으로 ''cron.log''와 같이 스케줄러와 관련된 이름을 사용하여, 해당 로그가 어떤 목적으로 기록되었는지 직관적으로 파악할 수 있게 합니다. 이는 디버깅 및 운영 모니터링에 중요한 역할을 합니다.

----
==== 3) 환경 변수 로드 및 파이썬 스크립트 실행 ====
이 스크립트의 가장 핵심적인 로직으로, ''.env'' 파일에 저장된 민감한 정보(API 키, 데이터베이스 비밀번호 등)를 환경 변수로 안전하게 로드하면서 파이썬 스크립트를 실행합니다.
  *   **''.env'' 파일 활용**: API 키, 비밀번호 등 보안상 중요한 정보들은 코드 내에 하드코딩하는 대신 별도의 ''.env'' 파일에 저장합니다. 이는 코드와 설정을 분리하여 보안성을 강화하고, 개발/운영 환경별 설정을 유연하게 관리할 수 있게 합니다.
  *   **''env $(grep -v '^#' "$ENV_FILE" | xargs)''**: 이 구문은 ''.env'' 파일에서 주석(<nowiki>^#</nowiki>)이 아닌 모든 라인을 읽어와 ''KEY=VALUE'' 형식의 환경 변수로 설정합니다. 이렇게 설정된 환경 변수들은 이후 실행될 파이썬 스크립트 내에서 ''os.getenv()'' 함수를 통해 안전하게 접근할 수 있습니다.
  *   **파이썬 가상환경 사용**: 지정된 파이썬 가상환경(''./.venv/bin/python'')을 이용하여 ''NewstoHR.py''를 실행합니다. 가상환경은 프로젝트별 파이썬 의존성을 격리하여 시스템 전역 파이썬 환경과의 충돌을 방지하고, 필요한 라이브러리만을 사용하여 실행 환경을 경량화합니다.
  *   **보안 및 유연성**: 이 방식은 민감 정보를 노출시키지 않으면서도, 파이썬 스크립트가 필요한 외부 연동 정보에 안전하게 접근할 수 있도록 하는 표준적이고 강력한 방법입니다.

----
==== 4) 실행 결과 로깅 ====
''NewstoHR.py'' 스크립트가 실행되면서 출력하는 모든 메시지(표준 출력)와 스크립트 자체의 오류 메시지(표준 오류)를 ''>> "$LOG_FILE" 2>&1'' 구문을 통해 ''cron.log'' 파일에 모두 기록합니다.
  *   **로그 리디렉션**:
    *   `>> "$LOG_FILE"`: 파이썬 스크립트의 표준 출력(예: `''print()''` 함수로 출력되는 메시지)을 지정된 로그 파일에 ''추가''합니다. 기존 로그 내용을 덮어쓰지 않고 계속 이어 붙입니다.
    *   `2>&1`: 표준 오류(파일을 찾을 수 없거나, 구문 오류 등 셸이나 스크립트 자체에서 발생하는 오류 메시지)를 표준 출력과 동일한 스트림으로 리디렉션합니다. 즉, 표준 오류 메시지도 ''cron.log'' 파일에 함께 기록되도록 합니다.
  *   **모니터링 및 디버깅**: 이 로깅 방식을 통해 스케줄링된 작업이 정상적으로 수행되었는지, 중간에 어떤 정보들이 출력되었는지, 그리고 오류가 발생했다면 정확히 어떤 오류 메시지가 발생했는지 추적할 수 있습니다. 이는 문제 발생 시 빠른 원인 파악과 해결에 필수적인 정보가 됩니다.

----
==== 5) 로그 기록 종료 ====
스크립트의 모든 작업이 성공적으로 또는 오류와 함께 완료되었음을 알리는 종료 로그를 ''cron.log'' 파일에 기록합니다.
  *   **작업 완료 확인**: 이 종료 로그는 해당 스케줄링된 작업의 한 사이클이 완전히 끝났음을 명확하게 나타냅니다.
  *   **실행 시간 분석**: 시작 로그와 종료 로그의 시간을 비교하여 스크립트의 총 실행 시간을 측정할 수 있습니다. 이는 성능 최적화나 타임아웃 문제 진단에 유용한 정보입니다.
  *   **완전성 보장**: 모든 로직이 실행된 후 최종적으로 기록되므로, 이 로그가 존재하면 스크립트가 최소한 끝까지 실행되었음을 보장할 수 있습니다.

<file>
#!/bin/bash

# 스크립트가 위치한 디렉토리로 이동하여 상대 경로 참조 문제 방지
BASE_DIR=$(cd "$(dirname "$0")" && pwd)
cd "$BASE_DIR"

# 로그 파일 및 환경 설정 파일 경로 정의
LOG_FILE="./cron.log"          # 로그 파일 경로 (현재 스크립트 디렉토리 기준)
ENV_FILE="./.env"              # 환경 변수 파일 경로
VENV_PYTHON="./.venv/bin/python" # 파이썬 가상환경 인터프리터 경로
PYTHON_SCRIPT="NewstoHR.py"    # 실행할 파이썬 스크립트 파일명

# 스크립트 시작 로그 기록
echo "==================================================" >> "$LOG_FILE"
echo "===== Crontab 스크립트 시작: $(date) =====" >> "$LOG_FILE"
echo "==================================================" >> "$LOG_FILE"
echo "" >> "$LOG_FILE" # 가독성을 위한 빈 줄 추가

# .env 파일의 변수들을 환경변수로 설정하고 파이썬 스크립트 실행 (핵심 로직)
# '^#'으로 시작하는 주석 라인은 제외하고 환경 변수로 로드
env $(grep -v '^#' "$ENV_FILE" | xargs) "$VENV_PYTHON" "$PYTHON_SCRIPT" >> "$LOG_FILE" 2>&1

# 스크립트 종료 로그 기록
echo "" >> "$LOG_FILE" # 가독성을 위한 빈 줄 추가
echo "==================================================" >> "$LOG_FILE"
echo "===== Crontab 스크립트 종료: $(date) =====" >> "$LOG_FILE"
echo "==================================================" >> "$LOG_FILE"
</file>

결론적으로 ''Automail.sh''는 복잡한 파이썬 프로젝트를 **[[wiki:glossary:server_operations:automation|자동화 환경]]**에서 안정적이고 효율적으로 구동하기 위한 필수적인 장치입니다. 이 래퍼 스크립트는 경로 문제 해결, 환경 변수 보안 로드, 가상 환경 활용, 그리고 체계적인 로깅을 통해 스케줄링된 작업의 신뢰성을 극대화하며, 운영상의 편의성과 문제 해결 능력을 크게 향상시킵니다.