Skip to main content

@webframp/gitlab-datastore

v2026.04.22.1

Stores swamp runtime data in GitLab using the Terraform state HTTP API. Provides distributed locking via GitLab's native state locking mechanism and bidirectional sync between local cache and GitLab.

Repository

https://github.com/webframp/swamp-extensions

Quality score

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @webframp/gitlab-datastore

GitLab Datastoreconfigurable
@webframp/gitlab-datastoregitlab_datastore/mod.ts

Stores swamp runtime data in GitLab using the Terraform state HTTP API with native locking support

Config Fields

FieldTypeDescription
projectIdstringGitLab project ID (numeric) or URL-encoded path (e.g., 'mygroup/myproject')
baseUrlstringGitLab instance URL
tokenstringGitLab personal access token or CI job token with api scope
username?stringGitLab username (optional, defaults to 'gitlab-ci-token')
statePrefixstringPrefix for state names to namespace swamp data