gitlab-catalog-browser 0.1.0

package/dist/types/api.js

@@ -0,0 +1,61 @@
+/**
+ * Shared API response and error types for GitLab API interactions.
+ */
+// ──────────────────────────────────────────────
+// API Error classes
+// ──────────────────────────────────────────────
+export class GitLabApiError extends Error {
+    statusCode;
+    code;
+    constructor(message, statusCode, code) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+        this.name = 'GitLabApiError';
+    }
+}
+export class AuthenticationError extends GitLabApiError {
+    constructor(message = 'Authentication failed — token may be expired or invalid') {
+        super(message, 401, 'AUTHENTICATION_FAILED');
+        this.name = 'AuthenticationError';
+    }
+}
+export class PermissionError extends GitLabApiError {
+    constructor(message = 'Insufficient permissions for this resource') {
+        super(message, 403, 'PERMISSION_DENIED');
+        this.name = 'PermissionError';
+    }
+}
+export class NotFoundError extends GitLabApiError {
+    constructor(resource) {
+        super(`Resource not found: ${resource}`, 404, 'NOT_FOUND');
+        this.name = 'NotFoundError';
+    }
+}
+export class RateLimitError extends GitLabApiError {
+    retryAfterSeconds;
+    constructor(message, retryAfterSeconds) {
+        super(message, 429, 'RATE_LIMITED');
+        this.retryAfterSeconds = retryAfterSeconds;
+        this.name = 'RateLimitError';
+    }
+}
+export class ServerError extends GitLabApiError {
+    constructor(statusCode, statusText) {
+        super(`GitLab server error: ${statusCode} ${statusText}`, statusCode, 'SERVER_ERROR');
+        this.name = 'ServerError';
+    }
+}
+export class NetworkError extends GitLabApiError {
+    constructor(url, cause) {
+        super(`Unable to reach GitLab instance at ${url}: ${cause}`, 0, 'NETWORK_ERROR');
+        this.name = 'NetworkError';
+    }
+}
+export class ConfigurationError extends GitLabApiError {
+    constructor(message) {
+        super(message, 0, 'CONFIGURATION_ERROR');
+        this.name = 'ConfigurationError';
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,iDAAiD;AACjD,oBAAoB;AACpB,iDAAiD;AAEjD,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGrB;IACA;IAHlB,YACE,OAAe,EACC,UAAkB,EAClB,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAQ;QAClB,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACrD,YAAY,OAAO,GAAG,yDAAyD;QAC7E,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,uBAAuB,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACjD,YAAY,OAAO,GAAG,4CAA4C;QAChE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,mBAAmB,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C,YAAY,QAAgB;QAC1B,KAAK,CAAC,uBAAuB,QAAQ,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,cAAc;IAG9B;IAFlB,YACE,OAAe,EACC,iBAA0B;QAE1C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;QAFpB,sBAAiB,GAAjB,iBAAiB,CAAS;QAG1C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,cAAc;IAC7C,YAAY,UAAkB,EAAE,UAAkB;QAChD,KAAK,CAAC,wBAAwB,UAAU,IAAI,UAAU,EAAE,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;QACtF,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,cAAc;IAC9C,YAAY,GAAW,EAAE,KAAa;QACpC,KAAK,CAAC,sCAAsC,GAAG,KAAK,KAAK,EAAE,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;QACjF,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,qBAAqB,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/types/catalog.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Catalog-specific type definitions for GitLab CI/CD Catalog components.
+ */
+/**
+ * Summary info for a catalog component (as returned by list/search).
+ */
+export interface CatalogComponent {
+    id: number;
+    name: string;
+    /** Full path including namespace, e.g. "to-be-continuous/docker-build" */
+    full_path: string;
+    /** Latest version string, e.g. "1.2.0" */
+    version: string;
+    /** Human-readable description */
+    description: string;
+    /** Latest tag, e.g. "v1.2.0" */
+    latest_tag?: string;
+    /** When the component was last updated */
+    updated_at?: string;
+}
+/**
+ * Detailed component info including specification.
+ */
+export interface CatalogComponentDetail extends CatalogComponent {
+    /** Full YAML specification content */
+    spec?: string;
+    /** Input parameter definitions */
+    inputs?: ComponentInput[];
+    /** Job definitions */
+    jobs?: ComponentJob[];
+    /** Workflow definitions */
+    workflows?: ComponentWorkflow[];
+}
+export interface ComponentInput {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'array';
+    required: boolean;
+    default?: unknown;
+    description?: string;
+    /** Regex validation pattern */
+    regex?: string;
+    /** Constrained options */
+    options?: string[];
+}
+export interface ComponentJob {
+    name: string;
+    stage: string;
+    image?: string;
+    script: string[];
+    /** Variables defined at job level */
+    variables?: Record<string, string>;
+    /** Job dependencies (needs) */
+    needs?: string[];
+    /** Rules/conditions */
+    rules?: string[];
+    /** When condition */
+    when?: string;
+}
+export interface ComponentWorkflow {
+    name: string;
+    /** Trigger conditions */
+    triggers: string[];
+    /** Jobs included in this workflow */
+    jobs: string[];
+    /** Rules for this workflow */
+    rules?: string[];
+}
+/**
+ * GitLab namespace/project info for API calls.
+ * Used to resolve a namespace to a project ID for catalog API calls.
+ */
+export interface NamespaceInfo {
+    id: number;
+    name: string;
+    full_path: string;
+}
+//# sourceMappingURL=catalog.d.ts.map

package/dist/types/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/types/catalog.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,sBAAsB;IACtB,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;IACtB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qCAAqC;IACrC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/catalog.js

@@ -0,0 +1,5 @@
+/**
+ * Catalog-specific type definitions for GitLab CI/CD Catalog components.
+ */
+export {};
+//# sourceMappingURL=catalog.js.map

package/dist/types/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/types/catalog.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "gitlab-catalog-browser",
+  "version": "0.1.0",
+  "description": "CLI tool for AI agents to browse GitLab CI/CD Catalog, inspect component schemas, and validate pipeline configurations",
+  "type": "module",
+  "bin": {
+    "gitlab-ci-cli": "./bin/gitlab-ci-cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node bin/gitlab-ci-cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "prepack": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kouassives/gitlab-catalog-browser.git"
+  },
+  "homepage": "https://github.com/kouassives/gitlab-catalog-browser",
+  "bugs": {
+    "url": "https://github.com/kouassives/gitlab-catalog-browser/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "keywords": [
+    "gitlab",
+    "ci-cd",
+    "cli",
+    "catalog",
+    "devops"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "js-yaml": "^4.1.1"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "skill-data/",
+    "skills/",
+    "package.json",
+    "README.md"
+  ]
+}

package/skill-data/core/reference.md

@@ -0,0 +1,127 @@
+---
+name: core
+description: Full command reference for gitlab-ci-cli
+---
+
+# Command Reference
+
+## Global Flags
+
+| Flag | Description |
+|------|-------------|
+| `--gitlab-url <url>` | GitLab instance URL (default: https://gitlab.com) |
+| `--token <token>` | GitLab personal access token |
+
+## Commands
+
+### init
+Initialize project configuration and verify environment.
+
+```bash
+gitlab-ci-cli init [--force] [--completion bash|zsh]
+```
+
+### upgrade
+Check for and apply CLI upgrades.
+
+```bash
+gitlab-ci-cli upgrade [--dry-run]
+```
+
+### doctor
+Run comprehensive environment diagnostics.
+
+```bash
+gitlab-ci-cli doctor [--json]
+```
+
+### catalog list
+List all catalog components in a namespace.
+
+```bash
+gitlab-ci-cli catalog list --org <namespace> [--json] [--page <n>] [--per-page <n>]
+```
+
+### catalog search
+Search catalog components by keyword.
+
+```bash
+gitlab-ci-cli catalog search <query> [--json] [--page <n>] [--per-page <n>]
+```
+
+### catalog info
+Show detailed information about a specific component.
+
+```bash
+gitlab-ci-cli catalog info <full-path> [--json]
+```
+
+### component schema
+Get the complete YAML specification of a component.
+
+```bash
+gitlab-ci-cli component schema <full-path> [--version <version>] [--output-file <path>]
+```
+
+### component inputs
+List all input parameters for a component.
+
+```bash
+gitlab-ci-cli component inputs <full-path> [--json]
+```
+
+### component workflows
+List workflow definitions for a component.
+
+```bash
+gitlab-ci-cli component workflows <full-path>
+```
+
+### component jobs
+List job definitions for a component.
+
+```bash
+gitlab-ci-cli component jobs <full-path> [--with-artifacts]
+```
+
+### validate
+Validate a .gitlab-ci.yml pipeline configuration.
+
+```bash
+gitlab-ci-cli validate <file> [--stdin] [--dry-run] [--project <path>] [--var <key=value>] [--json]
+```
+
+### pipeline explain
+Show job dependency graph for specified jobs.
+
+```bash
+gitlab-ci-cli pipeline explain <file> --jobs <list> [--json]
+```
+
+### pipeline trace
+Trace variable usage across the pipeline.
+
+```bash
+gitlab-ci-cli pipeline trace <file> --var <name> [--json]
+```
+
+### pipeline stages
+List pipeline stages and their jobs.
+
+```bash
+gitlab-ci-cli pipeline stages <file> [--mermaid] [--json]
+```
+
+### pipeline includes
+Show include hierarchy of the pipeline.
+
+```bash
+gitlab-ci-cli pipeline includes <file> [--json]
+```
+
+### pipeline summary
+Generate a structured pipeline summary.
+
+```bash
+gitlab-ci-cli pipeline summary <file> [--json]
+```

package/skill-data/core/templates.md

@@ -0,0 +1,97 @@
+---
+name: core
+description: Pipeline template patterns and best practices
+---
+
+# Pipeline Template Patterns
+
+## Basic Three-Stage Pipeline
+
+```yaml
+stages: [build, test, deploy]
+
+build:
+  stage: build
+  script: echo "Building..."
+
+test:
+  stage: test
+  script: echo "Testing..."
+  needs: [build]
+
+deploy:
+  stage: deploy
+  script: echo "Deploying..."
+  needs: [test]
+  when: manual
+```
+
+## Multi-Stage with Approvals
+
+```yaml
+stages: [build, test, staging, production]
+
+build:
+  stage: build
+  script: make build
+  artifacts:
+    paths: [dist/]
+
+test:
+  stage: test
+  script: make test
+  needs: [build]
+
+deploy-staging:
+  stage: staging
+  script: make deploy-staging
+  needs: [test]
+  environment: staging
+
+deploy-production:
+  stage: production
+  script: make deploy-production
+  needs: [deploy-staging]
+  when: manual
+  environment: production
+```
+
+## Docker Build Pipeline
+
+```yaml
+stages: [build, test, push]
+
+variables:
+  IMAGE_TAG: $CI_COMMIT_SHORT_SHA
+
+docker-build:
+  stage: build
+  image: docker:latest
+  services: [docker:dind]
+  script:
+    - docker build -t $CI_REGISTRY_IMAGE:$IMAGE_TAG .
+    - docker tag $CI_REGISTRY_IMAGE:$IMAGE_TAG $CI_REGISTRY_IMAGE:latest
+
+docker-test:
+  stage: test
+  script:
+    - docker run $CI_REGISTRY_IMAGE:$IMAGE_TAG test
+  needs: [docker-build]
+
+docker-push:
+  stage: push
+  script:
+    - docker push $CI_REGISTRY_IMAGE:$IMAGE_TAG
+    - docker push $CI_REGISTRY_IMAGE:latest
+  needs: [docker-test]
+  only: [main]
+```
+
+## Best Practices
+
+1. **Use needs explicitly**: Always declare job dependencies for clarity and performance
+2. **Leverage artifacts**: Pass build outputs between stages instead of rebuilding
+3. **Use rules over only/except**: `rules:` provides more flexible conditionals
+4. **Cache dependencies**: Use `cache:` for package managers (npm, pip, maven)
+5. **Keep stages parallel**: Design jobs within the same stage to run independently
+6. **Use manual gates**: Mark deployment jobs as `when: manual` for production safety

package/skill-data/core/workflows.md

@@ -0,0 +1,84 @@
+---
+name: core
+description: Core workflow instructions for using gitlab-ci-cli
+---
+
+# Core Workflows
+
+## Overview
+
+gitlab-ci-cli is a CLI tool for AI agents to browse the GitLab CI/CD Catalog, inspect component schemas, validate pipeline configurations, and analyze pipeline structures.
+
+## Browsing the Catalog
+
+```bash
+# List components in a namespace
+gitlab-ci-cli catalog list --org to-be-continuous
+
+# Search for components
+gitlab-ci-cli catalog search docker
+
+# Get component details
+gitlab-ci-cli catalog info to-be-continuous/docker-build
+```
+
+## Inspecting Component Schemas
+
+```bash
+# Get full YAML spec
+gitlab-ci-cli component schema to-be-continuous/docker-build
+
+# List input parameters
+gitlab-ci-cli component inputs to-be-continuous/docker-build
+
+# List workflows
+gitlab-ci-cli component workflows to-be-continuous/docker-build
+
+# List jobs
+gitlab-ci-cli component jobs to-be-continuous/docker-build
+```
+
+## Validating Pipelines
+
+```bash
+# Validate a .gitlab-ci.yml file
+gitlab-ci-cli validate .gitlab-ci.yml
+
+# Validate with dry-run rules evaluation
+gitlab-ci-cli validate .gitlab-ci.yml --dry-run
+
+# Validate with simulated variables
+gitlab-ci-cli validate .gitlab-ci.yml --dry-run --var CI_PIPELINE_SOURCE=merge_request_event
+
+# Validate with project context
+gitlab-ci-cli validate .gitlab-ci.yml --project my-group/my-project
+
+# Validate piped content
+echo "stages: [build]" | gitlab-ci-cli validate --stdin
+```
+
+## Analyzing Pipelines
+
+```bash
+# Show job dependency graph
+gitlab-ci-cli pipeline explain .gitlab-ci.yml --jobs build,test,deploy
+
+# Trace variable usage
+gitlab-ci-cli pipeline trace .gitlab-ci.yml --var MY_VAR
+
+# List stages
+gitlab-ci-cli pipeline stages .gitlab-ci.yml
+
+# Show include hierarchy
+gitlab-ci-cli pipeline includes .gitlab-ci.yml
+
+# Generate pipeline summary
+gitlab-ci-cli pipeline summary .gitlab-ci.yml
+```
+
+## Troubleshooting
+
+1. **Authentication errors**: Ensure GITLAB_TOKEN is set or pass `--token`
+2. **Component not found**: Verify the full path (e.g., `namespace/component-name`)
+3. **Pipeline validation failures**: Check the error details for line/column information
+4. **Dry-run unexpected results**: Verify branch conditions and variables match your context

package/skill-data/manifest.json

@@ -0,0 +1,12 @@
+{
+  "skills": [
+    {
+      "name": "core",
+      "description": "Core workflow instructions for using gitlab-ci-cli to browse, validate, and manage GitLab CI/CD pipelines"
+    },
+    {
+      "name": "templates",
+      "description": "Pipeline template patterns including basic, multi-stage, and Docker build configurations"
+    }
+  ]
+}

package/skill-data/templates/basic-pipeline.yml

@@ -0,0 +1,29 @@
+stages: [build, test, deploy]
+
+variables:
+  APP_NAME: my-app
+
+build:
+  stage: build
+  script:
+    - echo "Building $APP_NAME"
+    - mkdir -p dist
+    - cp -r src/* dist/
+  artifacts:
+    paths: [dist/]
+    expire_in: 1 hour
+
+test:
+  stage: test
+  script:
+    - echo "Testing $APP_NAME"
+    - npm test
+  needs: [build]
+
+deploy:
+  stage: deploy
+  script:
+    - echo "Deploying $APP_NAME"
+  needs: [test]
+  when: manual
+  environment: production

package/skill-data/templates/docker-build.yml

@@ -0,0 +1,38 @@
+stages: [build, test, push]
+
+variables:
+  DOCKER_DRIVER: overlay2
+  IMAGE_TAG: $CI_COMMIT_SHORT_SHA
+
+docker-build:
+  stage: build
+  image: docker:latest
+  services:
+    - docker:dind
+  script:
+    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
+    - docker build -t $CI_REGISTRY_IMAGE:$IMAGE_TAG .
+    - docker tag $CI_REGISTRY_IMAGE:$IMAGE_TAG $CI_REGISTRY_IMAGE:latest
+
+docker-test:
+  stage: test
+  image: docker:latest
+  services:
+    - docker:dind
+  script:
+    - docker run $CI_REGISTRY_IMAGE:$IMAGE_TAG npm test
+  needs: [docker-build]
+
+docker-push:
+  stage: push
+  image: docker:latest
+  services:
+    - docker:dind
+  script:
+    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
+    - docker push $CI_REGISTRY_IMAGE:$IMAGE_TAG
+    - docker push $CI_REGISTRY_IMAGE:latest
+  needs: [docker-test]
+  only:
+    - main
+  environment: production

package/skill-data/templates/multi-stage.yml

@@ -0,0 +1,43 @@
+stages: [build, test, staging, production]
+
+variables:
+  CI_IMAGE_TAG: $CI_COMMIT_SHORT_SHA
+
+build:
+  stage: build
+  script:
+    - echo "Building image"
+    - docker build -t app:$CI_IMAGE_TAG .
+  artifacts:
+    paths: [Dockerfile]
+
+unit-test:
+  stage: test
+  script:
+    - echo "Running unit tests"
+    - docker run app:$CI_IMAGE_TAG npm test
+  needs: [build]
+
+integration-test:
+  stage: test
+  script:
+    - echo "Running integration tests"
+    - docker-compose -f ci/docker-compose.test.yml up --abort-on-container-exit
+  needs: [build]
+
+deploy-staging:
+  stage: staging
+  script:
+    - echo "Deploying to staging"
+    - kubectl set image deployment/app app=app:$CI_IMAGE_TAG
+  needs: [unit-test, integration-test]
+  environment: staging
+
+deploy-production:
+  stage: production
+  script:
+    - echo "Deploying to production"
+    - kubectl set image deployment/app app=app:$CI_IMAGE_TAG
+  needs: [deploy-staging]
+  when: manual
+  environment: production