Registry / devops / cdktf-gitlab-runner

cdktf-gitlab-runner

library0.0.1463pypypiunverified

A CDK for Terraform (CDKTF) construct to deploy GitLab Runner on Google Cloud Platform (GCP). Version 0.0.1463, pre-1.0 with rapid releases. Supports Python 3.9+ and CDKTF 0.12+.

devops gcp aws

npm install cdktf-cli@latest

github ↗package ↗

INSTALL

IMPORT

SIG · CDKTF-GITLAB-RUNNE

cdktf-gitlab-runner

devopspythonv0.0.1463

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

GitlabRunner

✓ from cdktf_gitlab_runner import GitlabRunner

✗ from cdktf-gitlab-runner import GitlabRunner

Hyphens are invalid in Python imports; use underscores.

Creates a basic GitLab Runner stack using CDKTF. Replace placeholders with actual GCP project and service account email.

from cdktf import App, TerraformStack from cdktf_gitlab_runner import GitlabRunner import os stack = TerraformStack(App(), 'gitlab-runner-example') # Minimal required config; adjust values as needed. # WARNING: Some attributes may require additional usage specifics. GitlabRunner( stack, id='my-runner', gitlab_url='https://gitlab.com', registration_token=os.environ.get('GITLAB_REG_TOKEN', 'your-default-token'), runner_name='my-runner', runner_count=1, machine_type='e2-medium', zone='us-central1-a', project_id=os.environ.get('GCP_PROJECT', 'my-project'), service_account_email=os.environ.get('SA_EMAIL', 'default@project.iam.gserviceaccount.com'), ) App().synth()

Debug

Known issues

breakingVersion 0.0.x is pre-release; breaking changes may occur without major version bump. Always pin exact version in requirements.

fix

Use `pip install cdktf-gitlab-runner==0.0.1463` to pin version.

affects: <1.0.0

gotchaThe construct requires existing GCP resources: a VPC network, subnetwork, and firewall rules. It does not create them. Missing resources cause deployment failures.

fix

Ensure VPC, subnetwork, and firewall rules (allow SSH and GitLab Runner traffic) exist in the specified project and region.

affects: all

gotchaThe runner uses a service account with roles/compute.instanceAdmin.v1 and roles/iam.serviceAccountUser. The user must grant these roles; construct does not do so.

fix

Grant the service account the necessary IAM roles before deploying.

affects: all

Upgrade

Version history

0.0.1463latest on PyPI · released Dec 10, 2025

Audit

Dependencies

cdktfrequiredCore CDKTF library required to synthesize Terraform configs

constructsrequiredRequired by CDKTF for construct base classes

Agent activity

33 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/neilkuan/cdktf-gitlab-runner.git ↗

packagehttps://pypi.org/project/cdktf-gitlab-runner/ ↗