com.pulumi.gitlab.kotlin.GroupArgs.kt Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of pulumi-gitlab-kotlin Show documentation
Show all versions of pulumi-gitlab-kotlin Show documentation
Build cloud applications and infrastructure by combining the safety and reliability of infrastructure as code with the power of the Kotlin programming language.
@file:Suppress("NAME_SHADOWING", "DEPRECATION")
package com.pulumi.gitlab.kotlin
import com.pulumi.core.Output
import com.pulumi.core.Output.of
import com.pulumi.gitlab.GroupArgs.builder
import com.pulumi.gitlab.kotlin.inputs.GroupPushRulesArgs
import com.pulumi.gitlab.kotlin.inputs.GroupPushRulesArgsBuilder
import com.pulumi.kotlin.ConvertibleToJava
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.applySuspend
import kotlin.Boolean
import kotlin.Int
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import kotlin.collections.List
import kotlin.jvm.JvmName
/**
* The `gitlab.Group` resource allows to manage the lifecycle of a group.
* > On GitLab SaaS, you must use the GitLab UI to create groups without a parent group. You cannot use this provider nor the API to do this.
* **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/groups.html)
* ## Example Usage
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as gitlab from "@pulumi/gitlab";
* const example = new gitlab.Group("example", {
* name: "example",
* path: "example",
* description: "An example group",
* });
* // Create a project in the example group
* const exampleProject = new gitlab.Project("example", {
* name: "example",
* description: "An example project",
* namespaceId: example.id,
* });
* // Group with custom push rules
* const example_two = new gitlab.Group("example-two", {
* name: "example-two",
* path: "example-two",
* description: "An example group with push rules",
* pushRules: {
* authorEmailRegex: "@example\\.com$",
* commitCommitterCheck: true,
* memberCheck: true,
* preventSecrets: true,
* },
* });
* ```
* ```python
* import pulumi
* import pulumi_gitlab as gitlab
* example = gitlab.Group("example",
* name="example",
* path="example",
* description="An example group")
* # Create a project in the example group
* example_project = gitlab.Project("example",
* name="example",
* description="An example project",
* namespace_id=example.id)
* # Group with custom push rules
* example_two = gitlab.Group("example-two",
* name="example-two",
* path="example-two",
* description="An example group with push rules",
* push_rules={
* "author_email_regex": "@example\\.com$",
* "commit_committer_check": True,
* "member_check": True,
* "prevent_secrets": True,
* })
* ```
* ```csharp
* using System.Collections.Generic;
* using System.Linq;
* using Pulumi;
* using GitLab = Pulumi.GitLab;
* return await Deployment.RunAsync(() =>
* {
* var example = new GitLab.Group("example", new()
* {
* Name = "example",
* Path = "example",
* Description = "An example group",
* });
* // Create a project in the example group
* var exampleProject = new GitLab.Project("example", new()
* {
* Name = "example",
* Description = "An example project",
* NamespaceId = example.Id,
* });
* // Group with custom push rules
* var example_two = new GitLab.Group("example-two", new()
* {
* Name = "example-two",
* Path = "example-two",
* Description = "An example group with push rules",
* PushRules = new GitLab.Inputs.GroupPushRulesArgs
* {
* AuthorEmailRegex = "@example\\.com$",
* CommitCommitterCheck = true,
* MemberCheck = true,
* PreventSecrets = true,
* },
* });
* });
* ```
* ```go
* package main
* import (
* "github.com/pulumi/pulumi-gitlab/sdk/v8/go/gitlab"
* "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
* )
* func main() {
* pulumi.Run(func(ctx *pulumi.Context) error {
* example, err := gitlab.NewGroup(ctx, "example", &gitlab.GroupArgs{
* Name: pulumi.String("example"),
* Path: pulumi.String("example"),
* Description: pulumi.String("An example group"),
* })
* if err != nil {
* return err
* }
* // Create a project in the example group
* _, err = gitlab.NewProject(ctx, "example", &gitlab.ProjectArgs{
* Name: pulumi.String("example"),
* Description: pulumi.String("An example project"),
* NamespaceId: example.ID(),
* })
* if err != nil {
* return err
* }
* // Group with custom push rules
* _, err = gitlab.NewGroup(ctx, "example-two", &gitlab.GroupArgs{
* Name: pulumi.String("example-two"),
* Path: pulumi.String("example-two"),
* Description: pulumi.String("An example group with push rules"),
* PushRules: &gitlab.GroupPushRulesArgs{
* AuthorEmailRegex: pulumi.String("@example\\.com$"),
* CommitCommitterCheck: pulumi.Bool(true),
* MemberCheck: pulumi.Bool(true),
* PreventSecrets: pulumi.Bool(true),
* },
* })
* if err != nil {
* return err
* }
* return nil
* })
* }
* ```
* ```java
* package generated_program;
* import com.pulumi.Context;
* import com.pulumi.Pulumi;
* import com.pulumi.core.Output;
* import com.pulumi.gitlab.Group;
* import com.pulumi.gitlab.GroupArgs;
* import com.pulumi.gitlab.Project;
* import com.pulumi.gitlab.ProjectArgs;
* import com.pulumi.gitlab.inputs.GroupPushRulesArgs;
* import java.util.List;
* import java.util.ArrayList;
* import java.util.Map;
* import java.io.File;
* import java.nio.file.Files;
* import java.nio.file.Paths;
* public class App {
* public static void main(String[] args) {
* Pulumi.run(App::stack);
* }
* public static void stack(Context ctx) {
* var example = new Group("example", GroupArgs.builder()
* .name("example")
* .path("example")
* .description("An example group")
* .build());
* // Create a project in the example group
* var exampleProject = new Project("exampleProject", ProjectArgs.builder()
* .name("example")
* .description("An example project")
* .namespaceId(example.id())
* .build());
* // Group with custom push rules
* var example_two = new Group("example-two", GroupArgs.builder()
* .name("example-two")
* .path("example-two")
* .description("An example group with push rules")
* .pushRules(GroupPushRulesArgs.builder()
* .authorEmailRegex("@example\\.com$")
* .commitCommitterCheck(true)
* .memberCheck(true)
* .preventSecrets(true)
* .build())
* .build());
* }
* }
* ```
* ```yaml
* resources:
* example:
* type: gitlab:Group
* properties:
* name: example
* path: example
* description: An example group
* # Create a project in the example group
* exampleProject:
* type: gitlab:Project
* name: example
* properties:
* name: example
* description: An example project
* namespaceId: ${example.id}
* # Group with custom push rules
* example-two:
* type: gitlab:Group
* properties:
* name: example-two
* path: example-two
* description: An example group with push rules
* pushRules:
* authorEmailRegex: '@example\.com$'
* commitCommitterCheck: true
* memberCheck: true
* preventSecrets: true
* ```
*
* ## Import
* ```sh
* $ pulumi import gitlab:index/group:Group You can import a group state using ` `. The
* ```
* `id` can be whatever the [details of a group][details_of_a_group] api takes for
* its `:id` value, so for example:
* ```sh
* $ pulumi import gitlab:index/group:Group example example
* ```
* @property autoDevopsEnabled Default to Auto DevOps pipeline for all projects within this group.
* @property avatar A local path to the avatar image to upload. **Note**: not available for imported resources.
* @property avatarHash The hash of the avatar image. Use `filesha256("path/to/avatar.png")` whenever possible. **Note**: this is used to trigger an update of the avatar. If it's not given, but an avatar is given, the avatar will be updated each time.
* @property defaultBranchProtection See https://docs.gitlab.com/ee/api/groups.html#options-for-default*branch*protection. Valid values are: `0`, `1`, `2`, `3`, `4`.
* @property description The group's description.
* @property emailsEnabled Enable email notifications.
* @property extraSharedRunnersMinutesLimit Can be set by administrators only. Additional CI/CD minutes for this group.
* @property ipRestrictionRanges A list of IP addresses or subnet masks to restrict group access. Will be concatenated together into a comma separated string. Only allowed on top level groups.
* @property lfsEnabled Enable/disable Large File Storage (LFS) for the projects in this group.
* @property membershipLock Users cannot be added to projects in this group.
* @property mentionsDisabled Disable the capability of a group from getting mentioned.
* @property name The name of the group.
* @property parentId Id of the parent group (creates a nested group).
* @property path The path of the group.
* @property permanentlyRemoveOnDelete Whether the group should be permanently removed during a `delete` operation. This only works with subgroups. Must be configured via an `apply` before the `destroy` is run.
* @property preventForkingOutsideGroup Defaults to false. When enabled, users can not fork projects from this group to external namespaces.
* @property projectCreationLevel Determine if developers can create projects in the group. Valid values are: `noone`, `maintainer`, `developer`
* @property pushRules Push rules for the group.
* @property requestAccessEnabled Allow users to request member access.
* @property requireTwoFactorAuthentication Require all users in this group to setup Two-factor authentication.
* @property shareWithGroupLock Prevent sharing a project with another group within this group.
* @property sharedRunnersMinutesLimit Can be set by administrators only. Maximum number of monthly CI/CD minutes for this group. Can be nil (default; inherit system default), 0 (unlimited), or > 0.
* @property sharedRunnersSetting Enable or disable shared runners for a group’s subgroups and projects. Valid values are: `enabled`, `disabled_and_overridable`, `disabled_and_unoverridable`, `disabled_with_override`.
* @property subgroupCreationLevel Allowed to create subgroups. Valid values are: `owner`, `maintainer`.
* @property twoFactorGracePeriod Defaults to 48. Time before Two-factor authentication is enforced (in hours).
* @property visibilityLevel The group's visibility. Can be `private`, `internal`, or `public`. Valid values are: `private`, `internal`, `public`.
* @property wikiAccessLevel The group's wiki access level. Only available on Premium and Ultimate plans. Valid values are `disabled`, `private`, `enabled`.
*/
public data class GroupArgs(
public val autoDevopsEnabled: Output? = null,
public val avatar: Output? = null,
public val avatarHash: Output? = null,
public val defaultBranchProtection: Output? = null,
public val description: Output? = null,
public val emailsEnabled: Output? = null,
public val extraSharedRunnersMinutesLimit: Output? = null,
public val ipRestrictionRanges: Output>? = null,
public val lfsEnabled: Output? = null,
public val membershipLock: Output? = null,
public val mentionsDisabled: Output? = null,
public val name: Output? = null,
public val parentId: Output? = null,
public val path: Output? = null,
public val permanentlyRemoveOnDelete: Output? = null,
public val preventForkingOutsideGroup: Output? = null,
public val projectCreationLevel: Output? = null,
public val pushRules: Output? = null,
public val requestAccessEnabled: Output? = null,
public val requireTwoFactorAuthentication: Output? = null,
public val shareWithGroupLock: Output? = null,
public val sharedRunnersMinutesLimit: Output? = null,
public val sharedRunnersSetting: Output? = null,
public val subgroupCreationLevel: Output? = null,
public val twoFactorGracePeriod: Output? = null,
public val visibilityLevel: Output? = null,
public val wikiAccessLevel: Output? = null,
) : ConvertibleToJava {
override fun toJava(): com.pulumi.gitlab.GroupArgs = com.pulumi.gitlab.GroupArgs.builder()
.autoDevopsEnabled(autoDevopsEnabled?.applyValue({ args0 -> args0 }))
.avatar(avatar?.applyValue({ args0 -> args0 }))
.avatarHash(avatarHash?.applyValue({ args0 -> args0 }))
.defaultBranchProtection(defaultBranchProtection?.applyValue({ args0 -> args0 }))
.description(description?.applyValue({ args0 -> args0 }))
.emailsEnabled(emailsEnabled?.applyValue({ args0 -> args0 }))
.extraSharedRunnersMinutesLimit(extraSharedRunnersMinutesLimit?.applyValue({ args0 -> args0 }))
.ipRestrictionRanges(ipRestrictionRanges?.applyValue({ args0 -> args0.map({ args0 -> args0 }) }))
.lfsEnabled(lfsEnabled?.applyValue({ args0 -> args0 }))
.membershipLock(membershipLock?.applyValue({ args0 -> args0 }))
.mentionsDisabled(mentionsDisabled?.applyValue({ args0 -> args0 }))
.name(name?.applyValue({ args0 -> args0 }))
.parentId(parentId?.applyValue({ args0 -> args0 }))
.path(path?.applyValue({ args0 -> args0 }))
.permanentlyRemoveOnDelete(permanentlyRemoveOnDelete?.applyValue({ args0 -> args0 }))
.preventForkingOutsideGroup(preventForkingOutsideGroup?.applyValue({ args0 -> args0 }))
.projectCreationLevel(projectCreationLevel?.applyValue({ args0 -> args0 }))
.pushRules(pushRules?.applyValue({ args0 -> args0.let({ args0 -> args0.toJava() }) }))
.requestAccessEnabled(requestAccessEnabled?.applyValue({ args0 -> args0 }))
.requireTwoFactorAuthentication(requireTwoFactorAuthentication?.applyValue({ args0 -> args0 }))
.shareWithGroupLock(shareWithGroupLock?.applyValue({ args0 -> args0 }))
.sharedRunnersMinutesLimit(sharedRunnersMinutesLimit?.applyValue({ args0 -> args0 }))
.sharedRunnersSetting(sharedRunnersSetting?.applyValue({ args0 -> args0 }))
.subgroupCreationLevel(subgroupCreationLevel?.applyValue({ args0 -> args0 }))
.twoFactorGracePeriod(twoFactorGracePeriod?.applyValue({ args0 -> args0 }))
.visibilityLevel(visibilityLevel?.applyValue({ args0 -> args0 }))
.wikiAccessLevel(wikiAccessLevel?.applyValue({ args0 -> args0 })).build()
}
/**
* Builder for [GroupArgs].
*/
@PulumiTagMarker
public class GroupArgsBuilder internal constructor() {
private var autoDevopsEnabled: Output? = null
private var avatar: Output? = null
private var avatarHash: Output? = null
private var defaultBranchProtection: Output? = null
private var description: Output? = null
private var emailsEnabled: Output? = null
private var extraSharedRunnersMinutesLimit: Output? = null
private var ipRestrictionRanges: Output>? = null
private var lfsEnabled: Output? = null
private var membershipLock: Output? = null
private var mentionsDisabled: Output? = null
private var name: Output? = null
private var parentId: Output? = null
private var path: Output? = null
private var permanentlyRemoveOnDelete: Output? = null
private var preventForkingOutsideGroup: Output? = null
private var projectCreationLevel: Output? = null
private var pushRules: Output? = null
private var requestAccessEnabled: Output? = null
private var requireTwoFactorAuthentication: Output? = null
private var shareWithGroupLock: Output? = null
private var sharedRunnersMinutesLimit: Output? = null
private var sharedRunnersSetting: Output? = null
private var subgroupCreationLevel: Output? = null
private var twoFactorGracePeriod: Output? = null
private var visibilityLevel: Output? = null
private var wikiAccessLevel: Output? = null
/**
* @param value Default to Auto DevOps pipeline for all projects within this group.
*/
@JvmName("owyvgwnxriflabdb")
public suspend fun autoDevopsEnabled(`value`: Output) {
this.autoDevopsEnabled = value
}
/**
* @param value A local path to the avatar image to upload. **Note**: not available for imported resources.
*/
@JvmName("fkkvgvetrbcgdmul")
public suspend fun avatar(`value`: Output) {
this.avatar = value
}
/**
* @param value The hash of the avatar image. Use `filesha256("path/to/avatar.png")` whenever possible. **Note**: this is used to trigger an update of the avatar. If it's not given, but an avatar is given, the avatar will be updated each time.
*/
@JvmName("hdrqllnimjecgkpp")
public suspend fun avatarHash(`value`: Output) {
this.avatarHash = value
}
/**
* @param value See https://docs.gitlab.com/ee/api/groups.html#options-for-default*branch*protection. Valid values are: `0`, `1`, `2`, `3`, `4`.
*/
@JvmName("bafkeudhmdobxgxn")
public suspend fun defaultBranchProtection(`value`: Output) {
this.defaultBranchProtection = value
}
/**
* @param value The group's description.
*/
@JvmName("xpsrdcmidfcapnnu")
public suspend fun description(`value`: Output) {
this.description = value
}
/**
* @param value Enable email notifications.
*/
@JvmName("ivyafegwdxphmffh")
public suspend fun emailsEnabled(`value`: Output) {
this.emailsEnabled = value
}
/**
* @param value Can be set by administrators only. Additional CI/CD minutes for this group.
*/
@JvmName("eocncnflqgbvurab")
public suspend fun extraSharedRunnersMinutesLimit(`value`: Output) {
this.extraSharedRunnersMinutesLimit = value
}
/**
* @param value A list of IP addresses or subnet masks to restrict group access. Will be concatenated together into a comma separated string. Only allowed on top level groups.
*/
@JvmName("xqidovbuusjnurby")
public suspend fun ipRestrictionRanges(`value`: Output>) {
this.ipRestrictionRanges = value
}
@JvmName("nlnrhqmlvpxdddbc")
public suspend fun ipRestrictionRanges(vararg values: Output) {
this.ipRestrictionRanges = Output.all(values.asList())
}
/**
* @param values A list of IP addresses or subnet masks to restrict group access. Will be concatenated together into a comma separated string. Only allowed on top level groups.
*/
@JvmName("sxytxxcovhrncarx")
public suspend fun ipRestrictionRanges(values: List