개요

관리작업 원칙은 데이터 보정, 계약 복사, 캐시 정리, 인증서 생성, 배포 후 확인 같은 일회성 작업을 애플리케이션 코드와 같은 기준으로 관리하라는 뜻입니다. 운영자가 서버에서 즉흥적으로 실행한 명령은 재현하기 어렵고, 실패했을 때 추적하기도 어렵습니다.

HandStack은 관리작업을 위해 .bat, .ps1, .sh 스크립트를 적극적으로 사용합니다. 루트 스크립트는 전체 빌드와 배포를 다루고, 모듈별 task 스크립트는 계약 파일 복사, 실행, 정리, 인증서, 프로세스 제어 같은 작업을 담당합니다.

HandStack 관리작업의 범위

관리작업은 다음을 포함합니다.

• 환경 변수 설정
• 패키지 설치
• 빌드와 publish
• 계약 파일 정리와 복사
• 정적 자산 번들링과 압축
• 개발 인증서 생성
• 프로세스 시작/중지
• 배포 패키지 생성과 업데이트
• 원격 명령 실행
• 장애 분석과 디버깅

신규 개발자가 알아야 할 점

관리작업은 "서버에서 한번 실행하면 끝"이 아닙니다. 같은 작업을 다른 환경에서 다시 실행할 수 있어야 하며, 누가 실행해도 같은 결과를 내야 합니다.

스크립트는 다음 원칙을 지킵니다.

• 매개변수로 환경을 선택합니다.
• 실패 시 종료 코드를 명확히 반환합니다.
• 파일 복사는 OS에 맞는 도구를 사용합니다.
• 민감정보를 콘솔에 출력하지 않습니다.
• 실행 결과를 로그로 남깁니다.

마치며

HandStack의 관리작업은 운영 자동화의 핵심입니다. 신규 개발자는 .bat, .ps1, .sh를 단순 보조 파일로 보지 말고, 개발과 운영을 이어주는 표준 인터페이스로 다뤄야 합니다.