stackgate.ai
Alle integrationer

AWS CodeBuild

Start og overvåg CodeBuild-runs, læs CloudWatch-logs, og hent S3-artifacts inkl. Cypress-videoer via MCP.

Manual setup 8 værktøjer

Overblik

Forbind AWS CodeBuild, så AI-klienter kan starte og overvåge CI-builds, læse CloudWatch-logs (inkl. Cypress-output) og gennemse S3-artifacts som screenshots og videoer.

Integrationen bruger AWS CodeBuild API med IAM access keys, der gemmes krypteret i stackgate.ai. Forbruget afregnes på din AWS-konto.

Forudsætninger

  • En AWS-konto med mindst ét CodeBuild-projekt (fx en Cypress E2E-pipeline)
  • CloudWatch Logs aktiveret på projektet (standard for de fleste opsætninger)
  • Build-artifacts uploadet til S3 (kræves til list_build_artifacts og Cypress-videoer)
  • En stackgate.ai-konto

Credentials

  1. Opret en IAM-bruger i AWS IAM-konsollen med programmatic access.
  2. Vedhæft en least-privilege-politik med CodeBuild-, CloudWatch Logs- og S3-artifact-rettigheder (se den engelske guide for et JSON-eksempel).
  3. Opret en access key og kopiér key ID og secret.
  4. Gå til Mine integrationer → AWS CodeBuild på stackgate.ai.
  5. Klik Aktivér og indtast access key ID, secret access key, AWS-region og evt. et standard CodeBuild-projekt.

Sørg for, at CodeBuild-projektet sender logs til CloudWatch og uploader Cypress-artifacts (videoer findes ofte under cypress/videos/).

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/codebuild med Sanctum bearer token
  • Private gateway: én config til alle integrationer — brug codebuild__*-navngivne værktøjer

Typisk Cypress-workflow:

  1. start_build — start et run (valgfri source_version for branch/commit)
  2. get_build — poll indtil build_complete
  3. get_build_logs — læs CloudWatch-output (filter_pattern: Cypress eller error)
  4. list_build_artifacts — list S3-filer (suffix: .mp4 for videoer)
  5. get_artifact_file — presigned_url til videoer eller temp_storage til videregivelse mellem værktøjer

Se Dokumentation for HTTP-autentificering og opsætning af private gateway.

Fejlfinding

  • 422 integration not configured — udfyld alle påkrævede credential-felter i Mine integrationer.
  • 403 / AccessDenied fra AWS — verificér at IAM-politikken dækker CodeBuild, CloudWatch Logs og S3-artifact-bucket.
  • Logs ikke tilgængelige endnu — vent til buildet starter; CloudWatch log group/stream vises, når logging begynder.
  • Ingen artifact location — buildet kører måske stadig, fejlede før artifacts, eller projektet uploader ikke til S3.
  • CI-logs kan indeholde hemmeligheder — behandl log-output som følsomt.
  • Temp Storage-handoff — ved output_mode=temp_storage gælder Temp Storage-opbevaring (se privatlivspolitik).
  • 429 / throttling — undgå stram polling; brug pagination tokens på log- og artifact-værktøjer.

Tilgængelige værktøjer

  • list_projects

    List CodeBuild projects in the connected AWS account.

  • list_builds

    List build IDs for a CodeBuild project, newest first by default.

  • get_build

    Get normalized details for a CodeBuild run: status, phases, CloudWatch log pointers, and S3 artifact location.

  • start_build

    Start a new CodeBuild run for a project, with optional source version, buildspec, and environment variable overrides.

  • stop_build

    Stop a running CodeBuild build.

  • get_build_logs

    Hent CloudWatch-loghændelser for et CodeBuild-run. Brug filter_pattern til at indsnævre Cypress- eller fejl-output.

  • list_build_artifacts

    List filer i et builds S3-artifact-output. Filtrér efter prefix eller suffix (fx .mp4 til Cypress-videoer).

  • get_artifact_file

    Download en fil fra build-artifacts. Brug presigned_url til videoer eller temp_storage til videregivelse mellem værktøjer.

MCP-endpoint: https://stackgate.ai/mcp/codebuild (HTTP) eller via private gateway.

Relaterede workflows

Multi-integrations-playbooks, der bruger AWS CodeBuild til konkrete forretningsresultater.

Opret konto Dokumentation