pulumi-gitlab-kotlin/com.pulumi.gitlab.kotlin/Group

Group

class Group : KotlinCustomResource

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

Example Usage

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 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 exampleGroup = new Group("exampleGroup", GroupArgs.builder()
            .path("example")
            .description("An example group")
            .build());
        var exampleProject = new Project("exampleProject", ProjectArgs.builder()
            .description("An example project")
            .namespaceId(exampleGroup.id())
            .build());
    }
}
Content copied to clipboard

Import

$ pulumi import gitlab:index/group:Group You can import a group state using `<resource> <id>`. The
Content copied to clipboard

id can be whatever the details_of_a_group api takes for its :id value, so for example

$ pulumi import gitlab:index/group:Group example example
Content copied to clipboard

Properties

Link copied to clipboard
val autoDevopsEnabled: Output<Boolean>

Defaults to false. Default to Auto DevOps pipeline for all projects within this group.

Link copied to clipboard
val avatar: Output<String>?

A local path to the avatar image to upload. Note: not available for imported resources.

Link copied to clipboard
val avatarHash: Output<String>

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.

Link copied to clipboard
val avatarUrl: Output<String>

The URL of the avatar image.

Link copied to clipboard
val defaultBranchProtection: Output<Int>

Defaults to 2. See https://docs.gitlab.com/ee/api/groups.html#options-for-default*branch*protection

Link copied to clipboard
val description: Output<String>?

The description of the group.

Link copied to clipboard
val emailsDisabled: Output<Boolean>

Defaults to false. Disable email notifications.

Link copied to clipboard
val extraSharedRunnersMinutesLimit: Output<Int>

Can be set by administrators only. Additional CI/CD minutes for this group.

Link copied to clipboard
val fullName: Output<String>

The full name of the group.

Link copied to clipboard
val fullPath: Output<String>

The full path of the group.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val ipRestrictionRanges: Output<List<String>>?

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.

Link copied to clipboard
val lfsEnabled: Output<Boolean>

Defaults to true. Enable/disable Large File Storage (LFS) for the projects in this group.

Link copied to clipboard
val membershipLock: Output<Boolean>?

Users cannot be added to projects in this group.

Link copied to clipboard
val mentionsDisabled: Output<Boolean>

Defaults to false. Disable the capability of a group from getting mentioned.

Link copied to clipboard
val name: Output<String>

The name of this group.

Link copied to clipboard
val parentId: Output<Int>

Id of the parent group (creates a nested group).

Link copied to clipboard
val path: Output<String>

The path of the group.

Link copied to clipboard
val preventForkingOutsideGroup: Output<Boolean>

Defaults to false. When enabled, users can not fork projects from this group to external namespaces.

Link copied to clipboard
val projectCreationLevel: Output<String>

Defaults to maintainer. Determine if developers can create projects in the group.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val requestAccessEnabled: Output<Boolean>

Defaults to false. Allow users to request member access.

Link copied to clipboard
val requireTwoFactorAuthentication: Output<Boolean>

Defaults to false. Require all users in this group to setup Two-factor authentication.

Link copied to clipboard
val runnersToken: Output<String>

The group level registration token to use during runner setup.

Link copied to clipboard
val sharedRunnersMinutesLimit: Output<Int>

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.

Link copied to clipboard
val shareWithGroupLock: Output<Boolean>

Defaults to false. Prevent sharing a project with another group within this group.

Link copied to clipboard
val subgroupCreationLevel: Output<String>

Defaults to owner. Allowed to create subgroups.

Link copied to clipboard
val twoFactorGracePeriod: Output<Int>

Defaults to 48. Time before Two-factor authentication is enforced (in hours).

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard
val visibilityLevel: Output<String>

The group's visibility. Can be private, internal, or public.

Link copied to clipboard
val webUrl: Output<String>

Web URL of the group.