Интеграция GitLab API с сайтом

Интеграция GitLab API с сайтом

GitLab API используется для CI/CD интеграций, отображения статуса пайплайнов, управления задачами из внешних систем, и авторизации через GitLab OAuth. Особенно актуально для DevOps-инструментов и корпоративных порталов.

Аутентификация

import gitlab

# Personal Access Token
gl = gitlab.Gitlab('https://gitlab.com', private_token=GITLAB_TOKEN)

# OAuth2 для пользовательских приложений
gl = gitlab.Gitlab('https://gitlab.com', oauth_token=oauth_token)

Типичные сценарии

Статус CI/CD пайплайна на сайте:

def get_pipeline_status(project_id: int, ref: str = 'main') -> dict:
    project   = gl.projects.get(project_id)
    pipelines = project.pipelines.list(ref=ref, per_page=1)

    if not pipelines:
        return {'status': 'unknown'}

    pipeline = pipelines[0]
    return {
        'status':     pipeline.status,      # success/failed/running/pending
        'ref':        pipeline.ref,
        'sha':        pipeline.sha[:8],
        'started_at': pipeline.started_at,
        'duration':   pipeline.duration,
        'url':        pipeline.web_url,
    }

Триггер пайплайна из административной панели:

public function triggerDeploy(Request $request): JsonResponse
{
    $resp = Http::withToken(config('services.gitlab.token'))
        ->post("https://gitlab.com/api/v4/projects/{$projectId}/pipeline", [
            'ref'       => 'main',
            'variables' => [
                ['key' => 'DEPLOY_ENV', 'value' => $request->environment],
            ],
        ]);

    return response()->json(['pipeline_id' => $resp->json('id')]);
}

GitLab OAuth2

Route::get('/auth/gitlab/redirect', function () {
    return redirect('https://gitlab.com/oauth/authorize?' . http_build_query([
        'client_id'     => config('services.gitlab.client_id'),
        'redirect_uri'  => route('auth.gitlab.callback'),
        'response_type' => 'code',
        'scope'         => 'read_user read_api',
    ]));
});

Webhooks

GitLab поддерживает Push Events, Pipeline Events, Merge Request Events. Верификация через X-Gitlab-Token заголовок (секретный токен, заданный при создании webhook).

Сроки

Отображение статуса пайплайна + OAuth: 2–3 рабочих дня. Полная интеграция с управлением: 4–5 дней.