파일 및 예약 작업

이 가이드에서는 전용 컨테이너 페이지의 파일 관리 탭과 예약 작업 탭을 다룹니다. 파일을 업로드, 편집, 압축 및 압축 해제하는 방법과 컨테이너 내부에서 일정에 따라 명령을 실행하는 방법을 설명합니다.

#파일 관리자

컨테이너 페이지를 열고 파일 관리 탭으로 전환합니다. 파일 관리자의 루트 /는 컨테이너의 사이트 및 애플리케이션 디렉터리인 /var/www/html입니다. 이 디렉터리와 하위 디렉터리만 탐색하고 변경할 수 있습니다.

#탐색 및 편집

• 디렉터리 이름을 클릭하여 엽니다. 상단의 탐색 경로를 사용하여 상위 디렉터리로 이동합니다.
• 목록에는 이름, 크기, 수정 시간, 권한이 표시됩니다.
• 파일 옆의 더 보기(⋯) 버튼을 클릭하면 다음 작업을 수행할 수 있습니다.

#생성, 업로드 및 원격 다운로드

도구 모음에는 다음 버튼이 있습니다.

• 업로드: 로컬 파일을 현재 디렉터리에 업로드합니다.
• 원격 다운로드: https://example.com/file.zip과 같은 다운로드 URL과 저장할 파일 이름을 입력합니다. 서버가 파일을 현재 디렉터리로 직접 다운로드합니다. 다운로드는 진행률 표시와 함께 백그라운드에서 실행되며, 완료되면 "원격 다운로드가 완료되었습니다"이 표시됩니다.
• 새로 만들기: 유형(파일 또는 디렉터리)을 선택하고 이름을 입력합니다.
• 새로고침: 현재 디렉터리를 다시 불러옵니다.

압축과 압축 해제도 백그라운드에서 실행됩니다. 완료되면 "압축 완료" 또는 "압축 해제 완료"이 표시됩니다.

#파일 권한

앱과 예약된 cron 작업은 컨테이너의 www 사용자로 실행됩니다. 권한 문제가 발생하면 개요 탭의 빠른 작업에서 권한 복구를 클릭합니다. /var/www/html의 소유자와 권한이 재설정됩니다.

#예약 작업(cron)

예약 작업 탭에서는 cron 일정에 따라 컨테이너 내부에서 명령을 실행합니다. 주로 Laravel 스케줄러 실행, 캐시 삭제, 정기 백업 등에 사용합니다.

#예약 작업 생성

1. 예약 작업 탭으로 전환하고 작업 생성을 클릭합니다.

2. 양식을 작성합니다.

   필드	설명
   작업 이름	작업을 알아보기 쉬운 이름(예: backup_database)입니다.
   실행 일정	분, 시, 일, 월, 요일로 이루어진 표준 5개 필드 cron 표현식(예: */5 * * * *)입니다. 빠른 선택에서 자주 사용하는 사전 설정을 선택할 수 있습니다.
   실행 명령어	실행할 명령입니다. /usr/bin/php /var/www/html/artisan schedule:run과 같은 절대 경로를 사용합니다.
   실행 사용자	명령을 실행하는 사용자입니다.
   설명	선택적으로 입력하는 메모입니다.

3. 저장합니다. 작업이 목록에 표시됩니다.

#cron 표현식

표현식은 다음 범위를 갖는 다섯 개의 필드로 구성됩니다.

자주 사용하는 예시:

* * * * *      every minute
*/5 * * * *    every 5 minutes
0 * * * *      at the top of every hour
0 0 * * *      every day at 00:00
0 12 * * *     every day at 12:00
0 0 * * 1      every Monday at 00:00
0 0 1 * *      on the 1st of every month at 00:00

#작업 관리

목록에는 실행 일정, 명령어, 실행 사용자, 상태가 표시됩니다. 각 행에는 다음 제어 기능이 있습니다.

• 상태 스위치: 작업을 활성화하거나 비활성화합니다.
• 지금 실행(재생 아이콘): 명령을 즉시 한 번 실행하고 출력을 표시합니다. 디버깅에 유용합니다.
• 편집: 일정, 명령 및 기타 필드를 변경합니다.
• 삭제: 확인 후 작업을 삭제합니다.

#명령 작성 권장 사항

• 예약 실행에는 컨테이너의 www 사용자가 사용되므로 해당 사용자에게 명령에서 사용하는 파일의 읽기 및 쓰기 권한이 있어야 합니다.
• 명령에 작은따옴표(')를 넣지 않습니다. 로직이 복잡하면 /var/www/html/cron.sh와 같은 스크립트에 명령을 작성하고 작업에서 sh /var/www/html/cron.sh를 실행하도록 합니다.
• 각 실행 기록을 남기려면 ... >> /var/www/html/storage/cron.log 2>&1과 같이 출력을 직접 리디렉션합니다.

#웹 터미널 안내

컨테이너 페이지에는 웹 터미널 탭도 있습니다.