Skip to content

An open-source, self-hostable PaaS alternative to Vercel, Heroku & Netlify that lets you easily deploy static sites, databases, full-stack applications and 360+ one-click services on your own servers.

18.6 KB
Raw Blame
<?php

use App\Enums\ApplicationDeploymentStatus;
use App\Jobs\ApplicationDeploymentJob;
use App\Models\Application;
use App\Models\ApplicationDeploymentQueue;
use App\Models\AuditEvent;
use App\Models\Environment;
use App\Models\Project;
use App\Models\Server;
use App\Models\StandaloneDocker;
use App\Models\Team;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Bus;
use Illuminate\Support\Facades\DB;

uses(RefreshDatabase::class);

beforeEach(function () {
    $this->withoutDefer();
    Bus::fake([ApplicationDeploymentJob::class]);

    $this->team = Team::factory()->create();
    $this->server = Server::factory()->create(['team_id' => $this->team->id]);
    $this->destination = StandaloneDocker::factory()->create([
        'server_id' => $this->server->id,
        'network' => 'test-network-'.fake()->unique()->word(),
    ]);
    $this->project = Project::factory()->create(['team_id' => $this->team->id]);
    $this->environment = Environment::factory()->create(['project_id' => $this->project->id]);
});

function makeApplication(int $environmentId, int $destinationId, ?string $gitCommitSha): Application
{
    $attributes = [
        'environment_id' => $environmentId,
        'destination_id' => $destinationId,
        'destination_type' => StandaloneDocker::class,
    ];

    if ($gitCommitSha !== null) {
        $attributes['git_commit_sha'] = $gitCommitSha;
    }

    return Application::factory()->create($attributes);
}

describe('queue_application_deployment commit resolution', function () {
    test('inserts only while an admission transaction is open', function () {
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');
        $initialLevel = DB::transactionLevel();
        $creationLevel = null;

        ApplicationDeploymentQueue::created(function () use (&$creationLevel): void {
            $creationLevel = DB::transactionLevel();
        });

        queue_application_deployment($application, 'atomic-admission');

        expect($creationLevel)->toBeGreaterThan($initialLevel);
    });

    test('starts a deployment only while the admission transaction is open', function () {
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');
        $initialLevel = DB::transactionLevel();
        $startLevel = null;

        ApplicationDeploymentQueue::updated(function (ApplicationDeploymentQueue $deployment) use (&$startLevel): void {
            if ($deployment->status === ApplicationDeploymentStatus::IN_PROGRESS->value) {
                $startLevel = DB::transactionLevel();
            }
        });

        $result = queue_application_deployment($application, 'atomic-start');

        expect($result['status'])->toBe('queued')
            ->and($startLevel)->toBeGreaterThan($initialLevel);
        Bus::assertDispatchedTimes(ApplicationDeploymentJob::class, 1);
    });

    test('starts the next queued deployment only while a transaction is open', function (string $trigger) {
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');
        $this->server->settings->update(['concurrent_builds' => 0]);
        queue_application_deployment($application, 'waiting-deployment');
        $this->server->settings->update(['concurrent_builds' => 1]);
        $initialLevel = DB::transactionLevel();
        $startLevel = null;

        ApplicationDeploymentQueue::updated(function (ApplicationDeploymentQueue $deployment) use (&$startLevel): void {
            if ($deployment->status === ApplicationDeploymentStatus::IN_PROGRESS->value) {
                $startLevel = DB::transactionLevel();
            }
        });

        $trigger === 'queue_next_deployment'
            ? queue_next_deployment($application)
            : next_after_cancel($this->server);

        expect($startLevel)->toBeGreaterThan($initialLevel)
            ->and(ApplicationDeploymentQueue::query()->sole()->status)->toBe(ApplicationDeploymentStatus::IN_PROGRESS->value);
        Bus::assertDispatchedTimes(ApplicationDeploymentJob::class, 1);
    })->with(['queue_next_deployment', 'next_after_cancel']);

    test('does not start a queued deployment that another worker already started', function () {
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');
        $this->server->settings->update(['concurrent_builds' => 0]);
        queue_application_deployment($application, 'stale-deployment');
        $this->server->settings->update(['concurrent_builds' => 5]);
        $stale = ApplicationDeploymentQueue::query()->sole();

        ApplicationDeploymentQueue::query()->whereKey($stale->id)->update([
            'status' => ApplicationDeploymentStatus::IN_PROGRESS->value,
        ]);

        expect(start_queued_deployment($stale))->toBeFalse();
        Bus::assertNotDispatched(ApplicationDeploymentJob::class);
    });

    test('force starts a queued deployment only once when two requests hold the same queued row', function () {
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');
        $this->server->settings->update(['concurrent_builds' => 0]);
        queue_application_deployment($application, 'double-force-start');
        $firstClick = ApplicationDeploymentQueue::query()->sole();
        $secondClick = ApplicationDeploymentQueue::query()->sole();

        $firstResult = force_start_deployment($firstClick);
        $secondResult = force_start_deployment($secondClick);

        Bus::assertDispatchedTimes(ApplicationDeploymentJob::class, 1);
        expect($firstResult)->toBeTrue()
            ->and($secondResult)->toBeFalse()
            ->and(ApplicationDeploymentQueue::query()->sole()->status)->toBe(ApplicationDeploymentStatus::IN_PROGRESS->value);
    });

    test('force start bypasses the concurrency limits inside a transaction', function () {
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');
        queue_application_deployment($application, 'running-deployment');
        queue_application_deployment($application, 'forced-deployment', commit: 'another-commit');
        $forced = ApplicationDeploymentQueue::query()->where('deployment_uuid', 'forced-deployment')->sole();
        $initialLevel = DB::transactionLevel();
        $startLevel = null;

        ApplicationDeploymentQueue::updated(function (ApplicationDeploymentQueue $deployment) use (&$startLevel): void {
            if ($deployment->status === ApplicationDeploymentStatus::IN_PROGRESS->value) {
                $startLevel = DB::transactionLevel();
            }
        });

        expect($forced->status)->toBe(ApplicationDeploymentStatus::QUEUED->value)
            ->and(force_start_deployment($forced))->toBeTrue()
            ->and($startLevel)->toBeGreaterThan($initialLevel)
            ->and($forced->fresh()->status)->toBe(ApplicationDeploymentStatus::IN_PROGRESS->value);
        Bus::assertDispatchedTimes(ApplicationDeploymentJob::class, 2);
    });

    test('force start does not restart a deployment that is no longer queued', function (ApplicationDeploymentStatus $status) {
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');
        $this->server->settings->update(['concurrent_builds' => 0]);
        queue_application_deployment($application, 'not-queued-deployment');
        $stale = ApplicationDeploymentQueue::query()->sole();
        ApplicationDeploymentQueue::query()->whereKey($stale->id)->update(['status' => $status->value]);

        $result = force_start_deployment($stale);

        Bus::assertNotDispatched(ApplicationDeploymentJob::class);
        expect($stale->fresh()->status)->toBe($status->value)
            ->and($result)->toBeFalse();
    })->with([
        ApplicationDeploymentStatus::IN_PROGRESS,
        ApplicationDeploymentStatus::FINISHED,
        ApplicationDeploymentStatus::FAILED,
        ApplicationDeploymentStatus::CANCELLED_BY_USER,
    ]);

    test('skips a matching commit without creating or dispatching a second deployment', function () {
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');

        $first = queue_application_deployment($application, 'first-admission');
        $second = queue_application_deployment($application, 'second-admission');

        expect($first['status'])->toBe('queued')
            ->and($second['status'])->toBe('skipped')
            ->and($second['deployment_uuid'])->toBe('first-admission')
            ->and($second['existing_deployment']->deployment_uuid)->toBe('first-admission')
            ->and(ApplicationDeploymentQueue::query()->count())->toBe(1);
        Bus::assertDispatchedTimes(ApplicationDeploymentJob::class, 1);
    });

    test('allows explicit duplicate bypasses while queue capacity remains available', function (string $flag) {
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');

        queue_application_deployment($application, 'first-admission');
        $result = queue_application_deployment($application, 'bypass-admission', ...[$flag => true]);

        expect($result['status'])->toBe('queued')
            ->and(ApplicationDeploymentQueue::query()->count())->toBe(2);
    })->with(['force_rebuild', 'rollback', 'no_questions_asked']);

    test('checks duplicate commits across servers but uses the target server queue', function () {
        $otherServer = Server::factory()->create(['team_id' => $this->team->id]);
        $otherDestination = StandaloneDocker::factory()->create([
            'server_id' => $otherServer->id,
            'network' => 'test-network-'.fake()->unique()->word(),
        ]);
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');

        queue_application_deployment($application, 'first-server-admission');
        $skipped = queue_application_deployment($application, 'second-server-admission', server: $otherServer, destination: $otherDestination);
        $forced = queue_application_deployment($application, 'forced-second-server-admission', force_rebuild: true, server: $otherServer, destination: $otherDestination);

        expect($skipped['status'])->toBe('skipped')
            ->and($skipped['deployment_uuid'])->toBe('first-server-admission')
            ->and($forced['status'])->toBe('queued')
            ->and(ApplicationDeploymentQueue::query()->where('server_id', $otherServer->id)->sole()->deployment_uuid)->toBe('forced-second-server-admission');
    });

    test('rejects a full server queue before a different commit is inserted', function () {
        $this->server->settings->update(['concurrent_builds' => 0, 'deployment_queue_limit' => 1]);
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');

        queue_application_deployment($application, 'first-admission');
        $result = queue_application_deployment($application, 'full-admission', commit: 'another-commit');

        expect($result)->toBe([
            'status' => 'queue_full',
            'message' => 'Deployment queue is full. Please wait for existing deployments to complete.',
        ])->and(ApplicationDeploymentQueue::query()->where('status', ApplicationDeploymentStatus::QUEUED->value)->count())->toBe(1);
        Bus::assertNotDispatched(ApplicationDeploymentJob::class);
    });

    test('does not let a forced deployment exceed the queued limit', function () {
        $this->server->settings->update(['concurrent_builds' => 0, 'deployment_queue_limit' => 1]);
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');

        queue_application_deployment($application, 'first-admission');
        $result = queue_application_deployment($application, 'forced-full-admission', force_rebuild: true);

        expect($result['status'])->toBe('queue_full')
            ->and(ApplicationDeploymentQueue::query()->count())->toBe(1);
        Bus::assertNotDispatched(ApplicationDeploymentJob::class);
    });

    test('rejects a commit with disallowed characters before creating a deployment', function () {
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');

        expect(fn () => queue_application_deployment(
            application: $application,
            deployment_uuid: 'invalid-queued-commit',
            commit: 'abc;not-a-ref',
            is_webhook: true,
        ))->toThrow(Exception::class, 'Invalid deployment commit');

        $this->assertDatabaseMissing((new ApplicationDeploymentQueue)->getTable(), [
            'deployment_uuid' => 'invalid-queued-commit',
        ]);
        Bus::assertNotDispatched(ApplicationDeploymentJob::class);
    });

    test('validates the application fallback commit before creating a deployment', function () {
        $application = makeApplication(
            $this->environment->id,
            $this->destination->id,
            '$(not-a-ref)',
        );

        expect(fn () => queue_application_deployment(
            application: $application,
            deployment_uuid: 'invalid-fallback-commit',
        ))->toThrow(Exception::class, 'Invalid deployment commit');

        $this->assertDatabaseMissing((new ApplicationDeploymentQueue)->getTable(), [
            'deployment_uuid' => 'invalid-fallback-commit',
        ]);
        Bus::assertNotDispatched(ApplicationDeploymentJob::class);
    });

    test('rejects a stored queue commit with disallowed characters', function () {
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');
        queue_application_deployment($application, 'stored-invalid-commit');

        $deployment = ApplicationDeploymentQueue::query()
            ->where('deployment_uuid', 'stored-invalid-commit')
            ->sole();
        $deployment->update(['commit' => "abc\nnot-a-ref"]);

        expect(fn () => new ApplicationDeploymentJob($deployment->id))
            ->toThrow(Exception::class, 'Invalid deployment commit');
    });

    test('records a team audit event when a user queues a deployment', function () {
        $user = User::factory()->create();
        $this->team->members()->attach($user, ['role' => 'owner']);
        $this->actingAs($user);
        session(['currentTeam' => $this->team]);
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');

        queue_application_deployment($application, 'audit-deploy-uuid');

        $this->assertDatabaseHas('audit_events', [
            'team_id' => $this->team->id,
            'event' => 'ui.application.deployed',
            'resource_uuid' => $application->uuid,
        ]);
    });

    test('uses the deployed application team for the audit event', function () {
        $actorTeam = Team::factory()->create();
        $user = User::factory()->create();
        $actorTeam->members()->attach($user, ['role' => 'owner']);
        $this->actingAs($user);
        session()->forget('currentTeam');
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');

        queue_application_deployment($application, 'resource-team-audit-deploy');

        $event = AuditEvent::query()->where('event', 'ui.application.deployed')->sole();

        expect($event->team_id)->toBe($this->team->id)
            ->and($event->team_id)->not->toBe($actorTeam->id)
            ->and($event->resource_uuid)->toBe($application->uuid)
            ->and($event->metadata)->not->toHaveKey('team_id');
    });

    test('records only the rollback audit event when a user queues a rollback', function () {
        $user = User::factory()->create();
        $this->team->members()->attach($user, ['role' => 'owner']);
        $this->actingAs($user);
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');
        AuditEvent::query()->delete();

        queue_application_deployment(
            application: $application,
            deployment_uuid: 'audit-rollback-uuid',
            commit: 'previous-commit',
            rollback: true,
        );

        expect(AuditEvent::query()->pluck('event')->all())->toBe([
            'ui.application.rollback',
        ]);
    });

    test('uses application git_commit_sha when commit parameter omitted', function () {
        $pinnedSha = 'abc123def456abc123def456abc123def456abc1';
        $application = makeApplication($this->environment->id, $this->destination->id, $pinnedSha);

        $result = queue_application_deployment(
            application: $application,
            deployment_uuid: 'test-deploy-uuid-1',
        );

        expect($result['status'])->toBe('queued');

        $deployment = ApplicationDeploymentQueue::where('deployment_uuid', 'test-deploy-uuid-1')->first();
        expect($deployment)->not->toBeNull();
        expect($deployment->commit)->toBe($pinnedSha);
    });

    test('falls back to HEAD when both commit parameter and git_commit_sha are unset', function () {
        $application = makeApplication($this->environment->id, $this->destination->id, 'HEAD');

        $result = queue_application_deployment(
            application: $application,
            deployment_uuid: 'test-deploy-uuid-2',
        );

        expect($result['status'])->toBe('queued');

        $deployment = ApplicationDeploymentQueue::where('deployment_uuid', 'test-deploy-uuid-2')->first();
        expect($deployment->commit)->toBe('HEAD');
    });

    test('explicit commit parameter overrides application git_commit_sha', function () {
        $pinnedSha = 'abc123def456abc123def456abc123def456abc1';
        $webhookSha = '111222333444555666777888999000aaabbbccc1';
        $application = makeApplication($this->environment->id, $this->destination->id, $pinnedSha);

        $result = queue_application_deployment(
            application: $application,
            deployment_uuid: 'test-deploy-uuid-3',
            commit: $webhookSha,
        );

        expect($result['status'])->toBe('queued');

        $deployment = ApplicationDeploymentQueue::where('deployment_uuid', 'test-deploy-uuid-3')->first();
        expect($deployment->commit)->toBe($webhookSha);
    });

    test('treats empty string commit parameter as unset and uses git_commit_sha', function () {
        $pinnedSha = 'abc123def456abc123def456abc123def456abc1';
        $application = makeApplication($this->environment->id, $this->destination->id, $pinnedSha);

        $result = queue_application_deployment(
            application: $application,
            deployment_uuid: 'test-deploy-uuid-4',
            commit: '',
        );

        expect($result['status'])->toBe('queued');

        $deployment = ApplicationDeploymentQueue::where('deployment_uuid', 'test-deploy-uuid-4')->first();
        expect($deployment->commit)->toBe($pinnedSha);
    });
});