Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hadenlabs/terraform-gitlab-project
terraform gitlab repository
https://github.com/hadenlabs/terraform-gitlab-project
gitlab hadenlabs peru project repository terraform terraform-modules
Last synced: 3 days ago
JSON representation
terraform gitlab repository
- Host: GitHub
- URL: https://github.com/hadenlabs/terraform-gitlab-project
- Owner: hadenlabs
- License: lgpl-3.0
- Created: 2021-03-19T00:04:08.000Z (over 3 years ago)
- Default Branch: develop
- Last Pushed: 2022-02-28T03:53:54.000Z (over 2 years ago)
- Last Synced: 2024-10-11T07:41:41.972Z (25 days ago)
- Topics: gitlab, hadenlabs, peru, project, repository, terraform, terraform-modules
- Language: Go
- Homepage:
- Size: 529 KB
- Stars: 2
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/contributing.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: docs/code_of_conduct.md
Awesome Lists containing this project
README
[](https://github.com/hadenlabs/terraform-gitlab-project/releases) [](https://github.com/hadenlabs/terraform-gitlab-project/actions?workflow=lint-code) [](https://github.com/hadenlabs/terraform-gitlab-project/actions?workflow=ci) [](https://github.com/hadenlabs/terraform-gitlab-project/actions?workflow=test) [](https://github.com/pre-commit/pre-commit) [](https://conventionalcommits.org) [](https://keepachangelog.com)
# terraform-gitlab-project
terraform-gitlab-project for gitlab
## Requirements
This is a list of plugins that need to be installed previously to enjoy all the goodies of this configuration:
- [Pyenv](https://github.com/pyenv/pyenv)
- [Docker](https://www.docker.com/)
- [python](https://www.python.org)
- [taskfile](https://github.com/go-task/task)
## Usage
```hcl
module "main" {
source = "hadenlabs/project/gitlab"
version = "0.3.3"
providers = {
gitlab = gitlab
}
name = "project-example"
description = "gitlab project"
visibility = "public"
}
```
Full working example can be found in [examples](./examples) folder.
## Examples
### common
```hcl
module "main" {
source = "hadenlabs/project/gitlab"
version = "0.3.3"
providers = {
gitlab = gitlab
}
name = "project-example"
description = "gitlab project"
visibility = "public"
}
```
### with group new
```hcl
resource "gitlab_group" "example" {
name = "example"
path = "example"
description = "An example group"
}
module "main" {
source = "hadenlabs/project/gitlab"
version = "0.3.3"
providers = {
gitlab = gitlab
}
namespace_id = gitlab_group.example.id
name = "project-example"
description = "gitlab project"
visibility = "public"
}
```
### with group exist
```hcl
data "gitlab_group" "example" {
full_path = "example"
}
module "main" {
source = "hadenlabs/project/gitlab"
version = "0.3.3"
providers = {
gitlab = gitlab
}
namespace_id = data.gitlab_group.example.id
name = "project-example"
description = "gitlab project"
visibility = "public"
}
```
## Requirements
| Name | Version |
|------|---------|
| [terraform](#requirement\_terraform) | >= 0.13 |
| [gitlab](#requirement\_gitlab) | >=3.5.0 |
## Providers
| Name | Version |
|------|---------|
| [gitlab](#provider\_gitlab) | >=3.5.0 |
## Modules
No modules.
## Resources
| Name | Type |
|------|------|
| [gitlab_project.this](https://registry.terraform.io/providers/gitlabhq/gitlab/latest/docs/resources/project) | resource |
## Inputs
| Name | Description | Type | Default | Required |
|------|-------------|------|---------|:--------:|
| [description](#input\_description) | The description of the project. | `string` | n/a | yes |
| [name](#input\_name) | The name of the project. | `string` | n/a | yes |
| [namespace\_id](#input\_namespace\_id) | The namespace (group or user) of the project. | `string` | `null` | no |
| [settings](#input\_settings) | Create and manage settings. | `map(any)` | `{}` | no |
| [tags](#input\_tags) | topics or tags of project. | `list(string)` | `[]` | no |
| [visibility](#input\_visibility) | The visibility of the project private or public. | `string` | `"private"` | no |
## Outputs
| Name | Description |
|------|-------------|
| [instance](#output\_instance) | output instance project |
## Help
**Got a question?**
File a GitHub [issue](https://github.com/hadenlabs/terraform-gitlab-project/issues).
## Contributing
### Bug Reports & Feature Requests
Please use the [issue tracker](https://github.com/hadenlabs/terraform-gitlab-project/issues) to report any bugs or file feature requests.
### Development
In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow.
1. **Fork** the repo on GitHub
2. **Clone** the project to your own machine
3. **Commit** changes to your own branch
4. **Push** your work back up to your fork
5. Submit a **Pull Request** so that we can review your changes
**NOTE:** Be sure to rebase the latest changes from "upstream" before making a pull request!
## Module Versioning
This Module follows the principles of [Semantic Versioning (SemVer)](https://semver.org/).
Using the given version number of `MAJOR.MINOR.PATCH`, we apply the following constructs:
1. Use the `MAJOR` version for incompatible changes.
1. Use the `MINOR` version when adding functionality in a backwards compatible manner.
1. Use the `PATCH` version when introducing backwards compatible bug fixes.
### Backwards compatibility in `0.0.z` and `0.y.z` version
- In the context of initial development, backwards compatibility in versions `0.0.z` is **not guaranteed** when `z` is
increased. (Initial development)
- In the context of pre-release, backwards compatibility in versions `0.y.z` is **not guaranteed** when `y` is
increased. (Pre-release)
## Copyright
Copyright © 2018-2021 [Hadenlabs](https://hadenlabs.com)
## Trademarks
All other trademarks referenced herein are the property of their respective owners.
## License
The code and styles are licensed under the LGPL-3.0 license [See project license.](LICENSE).
## Don't forget to 🌟 Star 🌟 the repo if you like terraform-gitlab-project
[Your feedback is appreciated](https://github.com/hadenlabs/terraform-gitlab-project/issues)