Laravel Envoy를 이용한 배포 자동화: 효율적인 PHP 프로젝트 관리의 핵심 🚀

안녕하세요, PHP 개발자 여러분! 오늘은 Laravel Envoy를 활용한 배포 자동화에 대해 심도 있게 알아보겠습니다. 이 글을 통해 여러분은 프로젝트 배포 과정을 획기적으로 개선하고, 개발 생산성을 크게 향상시킬 수 있을 것입니다. 🌟

Laravel Envoy는 PHP 프레임워크인 Laravel에서 제공하는 강력한 배포 자동화 도구입니다. 이를 통해 복잡한 배포 프로세스를 간소화하고, 인적 오류를 최소화할 수 있습니다. 특히 팀 프로젝트에서 일관된 배포 환경을 유지하는 데 큰 도움이 됩니다.

이 글에서는 Laravel Envoy의 기본 개념부터 고급 사용법까지 상세히 다루겠습니다. 또한, 실제 프로젝트에 적용할 수 있는 다양한 예제와 팁을 제공하여, 여러분의 개발 워크플로우를 한 단계 업그레이드할 수 있도록 돕겠습니다.

재능넷과 같은 복잡한 웹 애플리케이션을 운영하는 경우, 효율적인 배포 프로세스는 필수적입니다. Laravel Envoy를 마스터하면, 여러분도 재능넷처럼 안정적이고 효율적인 서비스 운영이 가능해질 것입니다. 그럼 지금부터 Laravel Envoy의 세계로 함께 들어가 볼까요? 💻✨

1. Laravel Envoy 소개 🌈

Laravel Envoy는 PHP 7.4 이상에서 동작하는 태스크 러너입니다. 원격 서버에서 일반적인 작업을 실행하기 위한 최소한의 클린 문법을 제공합니다. Blade 스타일의 문법을 사용하여 배포, 아티산 명령 등의 일반적인 작업을 쉽게 설정할 수 있습니다.

1.1 Laravel Envoy의 주요 특징

간결한 문법: Blade 템플릿 엔진과 유사한 문법을 사용하여 직관적인 스크립트 작성이 가능합니다.
병렬 실행: 여러 서버에 동시에 작업을 실행할 수 있어 배포 시간을 크게 단축할 수 있습니다.
SSH 기반: 안전한 SSH 프로토콜을 통해 원격 서버와 통신합니다.
다중 서버 지원: 여러 서버에 대한 작업을 쉽게 정의하고 실행할 수 있습니다.
사용자 정의 매크로: 반복적인 작업을 매크로로 정의하여 재사용성을 높일 수 있습니다.

1.2 Laravel Envoy vs 다른 배포 도구

Laravel Envoy는 다른 배포 도구들과 비교했을 때 몇 가지 독특한 장점을 가지고 있습니다:

Laravel Envoy는 PHP 개발자들에게 특히 유용합니다. Laravel 프레임워크와의 완벽한 통합, 간결한 문법, 그리고 경량화된 특성으로 인해 Laravel 프로젝트의 배포 자동화에 최적화되어 있습니다.

Capistrano나 Ansible과 같은 도구들은 더 복잡한 배포 시나리오에 적합할 수 있지만, 학습 곡선이 더 가파르고 설정이 복잡할 수 있습니다. Jenkins는 종합적인 CI/CD 솔루션으로, 더 큰 규모의 프로젝트나 복잡한 파이프라인이 필요한 경우에 적합합니다.

Laravel Envoy는 이러한 도구들 사이에서 '간단하면서도 강력한' 위치를 차지하고 있습니다. PHP 개발자들이 쉽게 접근할 수 있으면서도, 대부분의 배포 시나리오를 효과적으로 처리할 수 있는 능력을 갖추고 있죠.

1.3 Laravel Envoy의 작동 원리

Laravel Envoy는 다음과 같은 방식으로 작동합니다:

스크립트 정의: 개발자가 Blade 스타일의 문법을 사용하여 Envoy.blade.php 파일에 실행할 작업을 정의합니다.
명령 실행: 터미널에서 envoy run 명령을 사용하여 정의된 작업을 실행합니다.
SSH 연결: Envoy는 정의된 서버에 SSH로 연결합니다.
명령 전송: 연결된 서버로 정의된 명령을 전송합니다.
결과 수집: 명령 실행 결과를 수집하여 개발자에게 보고합니다.

이러한 작동 원리를 통해 Laravel Envoy는 복잡한 배포 프로세스를 간단한 명령어 하나로 자동화할 수 있게 해줍니다.

1.4 Laravel Envoy의 사용 사례

Laravel Envoy는 다양한 상황에서 유용하게 사용될 수 있습니다:

웹 애플리케이션 배포: 코드 업데이트, 의존성 설치, 데이터베이스 마이그레이션 등을 자동화합니다.
서버 관리: 여러 서버의 설정을 동시에 업데이트하거나 상태를 확인할 수 있습니다.
백업 자동화: 정기적인 데이터베이스 백업이나 파일 시스템 백업을 스케줄링할 수 있습니다.
CI/CD 파이프라인 통합: 지속적 통합 및 배포 프로세스의 일부로 Envoy 스크립트를 실행할 수 있습니다.
로그 관리: 여러 서버의 로그를 중앙 집중화하거나 분석하는 작업을 자동화할 수 있습니다.

예를 들어, 재능넷과 같은 플랫폼을 운영할 때 Laravel Envoy를 사용하면 새로운 기능 배포, 서버 성능 모니터링, 정기적인 데이터 백업 등을 효율적으로 관리할 수 있습니다. 이는 서비스의 안정성과 개발 생산성을 크게 향상시킬 수 있습니다.

다음 섹션에서는 Laravel Envoy의 설치 방법과 기본적인 사용법에 대해 자세히 알아보겠습니다. Laravel Envoy를 통해 여러분의 PHP 프로젝트 관리가 얼마나 편리해질 수 있는지 직접 경험해보세요! 🚀

2. Laravel Envoy 설치 및 기본 설정 🛠️

Laravel Envoy를 사용하기 위해서는 먼저 적절한 환경 설정과 설치 과정이 필요합니다. 이 섹션에서는 Laravel Envoy를 설치하고 기본적인 설정을 하는 방법에 대해 상세히 알아보겠습니다.

2.1 시스템 요구사항

Laravel Envoy를 설치하기 전에, 시스템이 다음 요구사항을 충족하는지 확인해야 합니다:

PHP 7.4 이상
Composer (PHP 패키지 관리자)
SSH 클라이언트

대부분의 현대적인 PHP 개발 환경은 이러한 요구사항을 충족합니다. 만약 재능넷과 같은 프로젝트를 운영 중이라면, 이미 이러한 환경이 구축되어 있을 것입니다.

2.2 Composer를 통한 Laravel Envoy 설치

Laravel Envoy는 Composer를 통해 쉽게 설치할 수 있습니다. 터미널에서 다음 명령을 실행하세요:

composer global require laravel/envoy

이 명령은 Laravel Envoy를 전역적으로 설치합니다. 설치가 완료되면, envoy 명령을 어디서든 사용할 수 있게 됩니다.

2.3 PATH 설정

Composer의 전역 설치 디렉토리가 시스템 PATH에 추가되어 있는지 확인해야 합니다. 대부분의 경우 자동으로 설정되지만, 그렇지 않은 경우 수동으로 추가해야 합니다.

Linux나 macOS의 경우, ~/.bashrc 또는 ~/.bash_profile 파일에 다음 라인을 추가하세요:

export PATH="$PATH:$HOME/.composer/vendor/bin"

Windows의 경우, 시스템 환경 변수 설정에서 PATH에 다음을 추가하세요:

C:\Users\YourUsername\AppData\Roaming\Composer\vendor\bin

변경 사항을 적용하려면 터미널을 재시작하거나, 다음 명령을 실행하세요:

source ~/.bashrc

2.4 설치 확인

설치가 제대로 되었는지 확인하기 위해, 터미널에서 다음 명령을 실행해보세요:

envoy --version

이 명령이 Laravel Envoy의 버전 정보를 출력한다면, 설치가 성공적으로 완료된 것입니다.

2.5 프로젝트에 Envoy.blade.php 파일 생성

Laravel Envoy를 사용하기 위해서는 프로젝트 루트 디렉토리에 Envoy.blade.php 파일을 생성해야 합니다. 이 파일에 실행할 작업들을 정의하게 됩니다.

다음은 기본적인 Envoy.blade.php 파일의 예시입니다:

@servers(['web' => 'user@example.com'])

@task('deploy')
    cd /path/to/project
    git pull origin master
    composer install
    php artisan migrate
@endtask

이 예시에서는 'web' 서버를 정의하고, 'deploy' 작업을 생성했습니다. 이 작업은 프로젝트 디렉토리로 이동, 최신 코드를 가져오기, 의존성 설치, 데이터베이스 마이그레이션을 수행합니다.

2.6 SSH 키 설정

Laravel Envoy는 SSH를 사용하여 원격 서버에 연결합니다. 따라서 SSH 키 설정이 필요합니다:

로컬 머신에서 SSH 키 쌍을 생성합니다:

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

생성된 공개 키(id_rsa.pub)를 원격 서버의 ~/.ssh/authorized_keys 파일에 추가합니다.
SSH 에이전트에 개인 키를 추가합니다:
```
ssh-add ~/.ssh/id_rsa
```

2.7 환경 변수 설정

민감한 정보(예: 데이터베이스 비밀번호)는 환경 변수를 통해 관리하는 것이 좋습니다. Laravel Envoy에서는 .env 파일을 사용하여 이러한 변수를 관리할 수 있습니다.

.env 파일 예시:

DB_PASSWORD=secret
DEPLOY_SERVER=user@example.com

이렇게 설정된 환경 변수는 Envoy 스크립트 내에서 다음과 같이 사용할 수 있습니다:

@servers(['web' => $DEPLOY_SERVER])

@task('deploy')
    echo "Deploying with DB password: {{ $DB_PASSWORD }}"
    // 배포 작업
@endtask

2.8 기본 설정 테스트

모든 설정이 완료되었다면, 간단한 테스트 작업을 실행해봅시다:

@task('test')
    echo "Hello from Envoy!"
@endtask

이 작업을 실행하려면 터미널에서 다음 명령을 입력하세요:

envoy run test

이 명령이 성공적으로 실행되고 "Hello from Envoy!"가 출력된다면, Laravel Envoy가 제대로 설정되었다는 의미입니다.

2.9 설정 시 주의사항

보안: Envoy.blade.php 파일에 민감한 정보를 직접 포함시키지 마세요. 대신 환경 변수를 사용하세요.
버전 관리: Envoy.blade.php 파일은 버전 관리 시스템(예: Git)에 포함시키는 것이 좋습니다. 하지만 .env 파일은 절대 포함시키지 마세요.
권한 관리: 원격 서버에서 Envoy 작업을 실행할 때 필요한 최소한의 권한만 부여하세요.

이제 Laravel Envoy의 기본적인 설치와 설정이 완료되었습니다. 다음 섹션에서는 Laravel Envoy를 사용하여 실제 배포 작업을 자동화하는 방법에 대해 자세히 알아보겠습니다. Laravel Envoy를 통해 재능넷과 같은 복잡한 웹 애플리케이션의 배포 프로세스를 얼마나 효율적으로 관리할 수 있는지 곧 경험하게 될 것입니다! 🚀

3. Laravel Envoy 기본 사용법 📘

Laravel Envoy의 기본적인 설치와 설정을 마쳤다면, 이제 실제로 어떻게 사용하는지 알아볼 차례입니다. 이 섹션에서는 Laravel Envoy의 기본적인 사용법과 주요 기능들을 상세히 살펴보겠습니다.

3.1 기본 문법 이해하기

Laravel Envoy는 Blade 템플릿 엔진과 유사한 문법을 사용합니다. 주요 구성 요소는 다음과 같습니다:

@servers: 연결할 서버를 정의합니다.
@task: 실행할 작업을 정의합니다.
@story: 여러 작업을 그룹화합니다.

기본적인 Envoy 스크립트의 구조는 다음과 같습니다:

@servers(['web' => 'user@example.com'])

@task('task_name')
    // 실행할 명령어들
@endtask

@story('story_name')
    task_name
    another_task
@endstory

3.2 서버 정의하기

서버는 @servers 지시문을 사용하여 정의합니다:

@servers(['web' => 'user@example.com', 'db' => 'user@db.example.com'])

여러 서버를 동시에 정의할 수도 있습니다:

@servers(['web' => ['web1.example.com', 'web2.example.com']])

3.3 작업(Task) 생성하기

작업은 @task 지시문을 사용하여 정의합니다:

@task('deploy', ['on' => 'web'])
    cd /path/to/project
    git pull origin master
    composer install --no-interaction --no-dev --prefer-dist
    php artisan migrate --force
@endtask

이 예제에서는 'deploy'라는 이름의 작업을 생성하고, 'web' 서버에서 실행하도록 지정했습니다.

3.4 스토리(Story) 만들기

스토리는 여러 작업을 순차적으로 실행할 수 있게 해줍니다:

@story('deploy')
    git
    composer
    migrate
@endstory

@task('git')
    git pull origin master
@endtask

@task('composer')
    composer install --no-interaction --no-dev --prefer-dist
@endtask

@task('migrate')
    php artisan migrate --force
@endtask

이 스토리는 'git', 'composer', 'migrate' 작업을 순서대로 실행합니다.

3.5 변수 사용하기

Envoy 스크립트 내에서 변수를 사용할 수 있습니다:

@setup
    $now = new DateTime();
@endsetup

@task('deploy')
    echo "Deployment started at {{ $now->format('Y-m-d H:i:s') }}"
    // 배포 작업
@endtask

3.6 조건문 사용하기

조건에 따라 다른 작업을 실행할 수 있습니다:

@task('deploy')
    @if ($environment === 'production')
        echo "Deploying to production!"
    @else
        echo "Deploying to staging!"
    @endif
    // 공통 배포 작업
@endtask

3.7 작업 실행하기

정의한 작업이나 스토리를 실행하려면 터미널에서 다음 명령을 사용합니다:

envoy run task_name

또는

envoy run story_name

3.8 병렬 실행

여러 서버에서 동시에 작업을 실행하려면 --parallel 옵션을 사용합니다:

envoy run deploy --parallel

3.9 확인 프롬프트 추가하기

중요한 작업 전에 사용자 확인을 받고 싶다면 @confirm 지시문을 사용할 수 있습니다:

@task('deploy')
    @confirm('Are you sure you want to deploy to production?')
        // 배포 작업
    @endconfirm
@endtask

3.10 알림 보내기

작업 완료 후 알림을 보내고 싶다면 @slack 지시문을 사용할 수 있습니다:

@finished
    @slack('webhook-url', '#channel', 'Deployment finished!')
@endfinished

3.11 실제 사용 예시: 재능넷 배포 자동화

재능넷과 같은 복잡한 웹 애플리케이션의 배포를 자동화하는 Envoy 스크립트를 만들어 보겠습니다:

@servers(['web' => 'user@jaenung.net'])

@setup
    $repository = 'git@github.com:jaenung/jaenung.net.git';
    $releases_dir = '/var/www/jaenung.net/releases';
    $app_dir = '/var/www/jaenung.net';
    $release = date('YmdHis');
    $new_release_dir = $releases_dir .'/  $release';
@endsetup

@story('deploy')
    clone_repository
    run_composer
    update_symlinks
    run_migrations
    optimize
    cleanup
@endstory

@task('clone_repository')
    echo 'Cloning repository'
    [ -d {{ $releases_dir }} ] || mkdir {{ $releases_dir }}
    git clone --depth 1 {{ $repository }} {{ $new_release_dir }}
    cd {{ $new_release_dir }}
    git reset --hard {{ $commit }}
@endtask

@task('run_composer')
    echo "Starting deployment ({{ $release }})"
    cd {{ $new_release_dir }}
    composer install --prefer-dist --no-scripts -q -o
@endtask

@task('update_symlinks')
    echo "Linking storage directory"
    rm -rf {{ $new_release_dir }}/storage
    ln -nfs {{ $app_dir }}/storage {{ $new_release_dir }}/storage

    echo 'Linking .env file'
    ln -nfs {{ $app_dir }}/.env {{ $new_release_dir }}/.env

    echo 'Linking current release'
    ln -nfs {{ $new_release_dir }} {{ $app_dir }}/current
@endtask

@task('run_migrations')
    echo "Running migrations"
    php {{ $new_release_dir }}/artisan migrate --force
@endtask

@task('optimize')
    echo "Optimizing installation"
    php {{ $new_release_dir }}/artisan optimize
@endtask

@task('cleanup')
    echo "Cleaning up old releases"
    cd {{ $releases_dir }}
    ls -dt {{ $releases_dir }}/* | tail -n +6 | xargs -d "\n" rm -rf;
@endtask

@after
    @slack('slack-webhook-url', '#deployments', 'Deployment to Jaenung.net finished!')
@endafter

이 스크립트는 다음과 같은 작업을 수행합니다:

Git 저장소에서 최신 코드를 클론합니다.
Composer를 통해 의존성을 설치합니다.
필요한 디렉토리와 파일의 심볼릭 링크를 생성합니다.
데이터베이스 마이그레이션을 실행합니다.
애플리케이션을 최적화합니다.
오래된 릴리스를 정리합니다.
배포가 완료되면 Slack으로 알림을 보냅니다.

이 스크립트를 실행하려면 다음 명령을 사용합니다:

envoy run deploy

3.12 주의사항 및 팁

보안: 민감한 정보(예: 비밀번호, API 키)는 환경 변수로 관리하고, 직접 스크립트에 하드코딩하지 마세요.
백업: 중요한 작업을 수행하기 전에 항상 백업을 만들어두세요.
테스트: 실제 프로덕션 환경에 적용하기 전에 스테이징 환경에서 충분히 테스트하세요.
롤백 계획: 배포가 실패했을 때를 대비한 롤백 절차를 마련해두세요.
모듈화: 복잡한 배포 프로세스는 여러 작은 작업으로 나누어 관리하세요.

이렇게 Laravel Envoy의 기본적인 사용법에 대해 알아보았습니다. 이를 통해 재능넷과 같은 복잡한 웹 애플리케이션의 배포 과정을 크게 간소화하고 자동화할 수 있습니다. 다음 섹션에서는 더 고급 기능과 실전 팁들을 살펴보겠습니다. Laravel Envoy를 통해 여러분의 개발 워크플로우가 얼마나 개선될 수 있는지 경험해보세요! 🚀

4. Laravel Envoy 고급 기능 및 팁 🔧

Laravel Envoy의 기본 사용법을 마스터했다면, 이제 더 강력하고 효율적인 배포 스크립트를 작성하기 위한 고급 기능들을 살펴볼 차례입니다. 이 섹션에서는 Laravel Envoy의 고급 기능과 실용적인 팁들을 소개하겠습니다.

4.1 다중 서버 배포

대규모 애플리케이션의 경우, 여러 서버에 동시에 배포해야 할 수 있습니다. Laravel Envoy는 이를 쉽게 처리할 수 있습니다:

@servers(['web-1' => 'user@server1.com', 'web-2' => 'user@server2.com'])

@task('deploy', ['on' => ['web-1', 'web-2']])
    cd /path/to/project
    git pull origin master
    composer install --no-interaction --no-dev --prefer-dist
    php artisan migrate --force
@endtask

이 스크립트는 'web-1'과 'web-2' 서버에 동시에 배포를 수행합니다.

4.2 병렬 실행 최적화

여러 서버에 배포할 때 병렬 실행을 활용하면 전체 배포 시간을 크게 단축할 수 있습니다:

envoy run deploy --parallel

주의: 병렬 실행 시 작업 순서가 중요한 경우 주의가 필요합니다.

4.3 환경별 설정

개발, 스테이징, 프로덕션 등 다양한 환경에 대해 다른 설정을 적용할 수 있습니다:

@servers(['prod' => 'user@production.com', 'staging' => 'user@staging.com'])

@task('deploy', ['on' => $on])
    cd /path/to/project
    git pull origin {{ $branch }}
    composer install --no-interaction --no-dev --prefer-dist
    php artisan migrate --force
    @if($on === 'prod')
        php artisan optimize
    @endif
@endtask

이 스크립트를 실행할 때 다음과 같이 환경과 브랜치를 지정할 수 있습니다:

envoy run deploy --on=prod --branch=master

4.4 사용자 정의 매크로

반복적으로 사용되는 명령어 세트를 매크로로 정의하여 재사용성을 높일 수 있습니다:

@macro('deploy')
    git
    composer
    migrate
    optimize
@endmacro

@task('git')
    git pull origin master
@endtask

@task('composer')
    composer install --no-interaction --no-dev --prefer-dist
@endtask

@task('migrate')
    php artisan migrate --force
@endtask

@task('optimize')
    php artisan optimize
@endtask

이제 envoy run deploy 명령으로 전체 배포 프로세스를 실행할 수 있습니다.

4.5 실행 시간 측정

각 작업의 실행 시간을 측정하여 배포 프로세스를 최적화할 수 있습니다:

@task('deploy')
    @time
        // 배포 작업
    @endtime
@endtask

4.6 에러 처리

작업 실행 중 발생할 수 있는 에러를 적절히 처리하는 것이 중요합니다:

@task('risky_task')
    @if($task->run('some_command') !== 0)
        throw new Exception('Command failed!');
    @endif
@endtask

4.7 동적 서버 선택

실행 시점에 동적으로 서버를 선택할 수 있습니다:

@servers(['web' => 'user@example.com'])

@task('deploy', ['on' => function($task) {
    return ask('Which server should we deploy to?');
}])
    // 배포 작업
@endtask

4.8 배포 히스토리 관리

각 배포의 로그를 저장하고 관리하는 것이 좋습니다:

@task('log_deploy')
    echo "Deployment finished at $(date)" >> /var/log/deployments.log
@endtask

4.9 Slack 통합 개선

배포 상태에 따라 다른 Slack 메시지를 보낼 수 있습니다:

@finished
    @success
        @slack('webhook-url', '#channel', 'Deployment succeeded!')
    @else
        @slack('webhook-url', '#channel', 'Deployment failed!')
    @endsuccess
@endfinished

4.10 배포 잠금

동시에 여러 배포가 실행되는 것을 방지하기 위해 배포 잠금을 구현할 수 있습니다:

@task('deploy')
    [ ! -f /tmp/deploy.lock ] || exit 1
    touch /tmp/deploy.lock

    // 배포 작업

    rm /tmp/deploy.lock
@endtask

4.11 롤백 기능 구현

배포가 실패했을 때를 대비한 롤백 기능을 구현하는 것이 좋습니다:

@task('rollback')
    cd /var/www/project
    ln -nfs $(ls -dt releases/* | head -n 2 | tail -n 1) current
    rm -rf $(ls -dt releases/* | head -n 1)
@endtask

4.12 성능 모니터링 통합

배포 후 애플리케이션의 성능을 모니터링하는 작업을 추가할 수 있습니다:

@task('monitor')
    curl -s https://example.com/health-check
    ab -n 1000 -c 100 https://example.com/
@endtask

4.13 실제 사용 예시: 재능넷 고급 배포 스크립트

이제 재능넷과 같은 복잡한 웹 애플리케이션을 위한 고급 배포 스크립트를 만들어 보겠습니다:

@servers(['prod-1' => 'user@prod1.jaenung.net', 'prod-2' => 'user@prod2.jaenung.net'])

@setup
    $repository = 'git@github.com:jaenung/jaenung.net.git';
    $releases_dir = '/var/www/jaenung.net/releases';
    $app_dir = '/var/www/jaenung.net';
    $release = date('YmdHis');
    $new_release_dir = $releases_dir . '/' . $release;
@endsetup

@story('deploy')
    check_lock
    clone_repository
    run_composer
    update_symlinks
    run_migrations
    optimize
    enable_maintenance_mode
    update_current_release
    disable_maintenance_mode
    cleanup
    health_check
@endstory

@task('check_lock', ['on' => 'prod-1'])
    if [ -f /tmp/jaenung_deploy.lock ]; then
        echo "Deployment is already in progress"
        exit 1
    fi
    touch /tmp/jaenung_deploy.lock
@endtask

@task('clone_repository', ['on' => 'prod-1'])
    echo 'Cloning repository'
    [ -d {{ $releases_dir }} ] || mkdir {{ $releases_dir }}
    git clone --depth 1 {{ $repository }} {{ $new_release_dir }}
    cd {{ $new_release_dir }}
    git reset --hard {{ $commit }}
@endtask

@task('run_composer', ['on' => 'prod-1'])
    echo "Installing dependencies"
    cd {{ $new_release_dir }}
    composer install --prefer-dist --no-scripts -q -o
@endtask

@task('update_symlinks', ['on' => 'prod-1'])
    echo "Linking storage directory"
    rm -rf {{ $new_release_dir }}/storage
    ln -nfs {{ $app_dir }}/storage {{ $new_release_dir }}/storage

    echo 'Linking .env file'
    ln -nfs {{ $app_dir }}/.env {{ $new_release_dir }}/.env
@endtask

@task('run_migrations', ['on' => 'prod-1'])
    echo "Running migrations"
    php {{ $new_release_dir }}/artisan migrate --force
@endtask

@task('optimize', ['on' => 'prod-1'])
    echo "Optimizing installation"
    php {{ $new_release_dir }}/artisan optimize
    php {{ $new_release_dir }}/artisan view:cache
@endtask

@task('enable_maintenance_mode', ['on' => ['prod-1', 'prod-2']])
    echo "Enabling maintenance mode"
    php {{ $app_dir }}/current/artisan down
@endtask

@task('update_current_release', ['on' => ['prod-1', 'prod-2']])
    echo 'Linking current release'
    ln -nfs {{ $new_release_dir }} {{ $app_dir }}/current
@endtask

@task('disable_maintenance_mode', ['on' => ['prod-1', 'prod-2']])
    echo "Disabling maintenance mode"
    php {{ $app_dir }}/current/artisan up
@endtask

@task('cleanup', ['on' => 'prod-1'])
    echo "Cleaning up old releases"
    cd {{ $releases_dir }}
    ls -dt {{ $releases_dir }}/* | tail -n +6 | xargs -d "\n" rm -rf;
@endtask

@task('health_check', ['on' => 'prod-1'])
    echo "Performing health check"
    @if($task->run("curl -s https://jaenung.net/health-check") !== 0)
        echo "Health check failed!"
        @slack('slack-webhook-url', '#deployments', 'Deployment to Jaenung.net failed health check!')
    @else
        echo "Health check passed!"
        @slack('slack-webhook-url', '#deployments', 'Deployment to Jaenung.net completed successfully!')
    @endif
@endtask

@finished
    @run('rm /tmp/jaenung_deploy.lock')
@endfinished

이 고급 스크립트는 다음과 같은 기능을 포함합니다:

배포 잠금 기능으로 동시 배포 방지
두 개의 프로덕션 서버에 대한 배포
무중단 배포를 위한 심볼릭 링크 사용
데이터베이스 마이그레이션
애플리케이션 최적화
배포 중 유지보수 모드 활성화/비활성화
이전 릴리스 정리
배포 후 헬스 체크
Slack을 통한 배포 상태 알림

이러한 고급 기능들을 활용하면 재능넷과 같은 복잡한 웹 애플리케이션의 배포 과정을 더욱 안정적이고 효율적으로 관리할 수 있습니다. Laravel Envoy를 통해 배포 프로세스를 자동화함으로써 개발팀은 더 중요한 작업에 집중할 수 있게 되고, 서비스의 안정성과 품질을 높일 수 있습니다.

다음 섹션에서는 Laravel Envoy를 사용할 때의 베스트 프랙티스와 주의사항에 대해 알아보겠습니다. 이를 통해 여러분은 더욱 안전하고 효과적인 배포 시스템을 구축할 수 있을 것입니다. 🚀