provider-gitlab

module
v0.9.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 23, 2024 License: Apache-2.0

README

provider-gitlab

Overview

provider-gitlab is the Crossplane infrastructure provider for Gitlab. The provider that is built from the source code in this repository can be installed into a Crossplane control plane and adds the following new functionality:

  • Custom Resource Definitions (CRDs) that model Gitlab resources
  • Controllers to provision these resources in Gitlab based on the users desired state captured in CRDs they create
  • Implementations of Crossplane's portable resource abstractions, enabling Gitlab resources to fulfill a user's general need for Gitlab configurations

Getting Started and Documentation

Create a Personal Access Token on your GitLab instance with the scope set to api and fill in the corresponding Kubernetes secret:

kubectl create secret generic gitlab-credentials -n crossplane-system --from-literal=token="<PERSONAL_ACCESS_TOKEN>"

Configure a ProviderConfig with a baseURL pointing to your GitLab instance:

apiVersion: gitlab.crossplane.io/v1beta1
kind: ProviderConfig
metadata:
  name: gitlab-provider
spec:
  baseURL: https://gitlab.com/
  credentials:
    source: Secret
    secretRef:
      namespace: crossplane-system
      name: gitlab-credentials
      key: token
kubectl apply -f examples/providerconfig/provider.yaml

Contributing

provider-gitlab is a community driven project and we welcome contributions. See the Crossplane Contributing guidelines to get started.

Report a Bug

For filing bugs, suggesting improvements, or requesting new features, please open an issue.

Contact

Please use the following to reach members of the community:

Governance and Owners

provider-gitlab is run according to the same Governance and Ownership structure as the core Crossplane project.

Code of Conduct

provider-gitlab adheres to the same Code of Conduct as the core Crossplane project.

Licensing

provider-gitlab is under the Apache 2.0 license.

FOSSA Status

Directories

Path Synopsis
Package apis contains Kubernetes API for GitLab API.
Package apis contains Kubernetes API for GitLab API.
groups/v1alpha1
Package v1alpha1 contains managed resources for Gitlab Groups +kubebuilder:object:generate=true +groupName=groups.gitlab.crossplane.io +versionName=v1alpha1
Package v1alpha1 contains managed resources for Gitlab Groups +kubebuilder:object:generate=true +groupName=groups.gitlab.crossplane.io +versionName=v1alpha1
projects/v1alpha1
Package v1alpha1 contains managed resources for Gitlab Projects +kubebuilder:object:generate=true +groupName=projects.gitlab.crossplane.io +versionName=v1alpha1
Package v1alpha1 contains managed resources for Gitlab Projects +kubebuilder:object:generate=true +groupName=projects.gitlab.crossplane.io +versionName=v1alpha1
v1alpha1
Package v1alpha1 contains core gitlab resources.
Package v1alpha1 contains core gitlab resources.
v1beta1
Package v1beta1 contains the core resources of the gitlab provider.
Package v1beta1 contains the core resources of the gitlab provider.
cmd
pkg

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL