Group
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());
}
}
Import
$ pulumi import gitlab:index/group:Group You can import a group state using `<resource> <id>`. The
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
Properties
Defaults to false. Default to Auto DevOps pipeline for all projects within this group.
Defaults to 2. See https://docs.gitlab.com/ee/api/groups.html#options-for-default*branch*protection
The description of the group.
Defaults to false. Disable email notifications.
Can be set by administrators only. Additional CI/CD minutes for this group.
Defaults to true. Enable/disable Large File Storage (LFS) for the projects in this group.
Users cannot be added to projects in this group.
Defaults to false. Disable the capability of a group from getting mentioned.
Defaults to false. When enabled, users can not fork projects from this group to external namespaces.
Defaults to maintainer. Determine if developers can create projects in the group.
Defaults to false. Allow users to request member access.
Defaults to false. Require all users in this group to setup Two-factor authentication.
The group level registration token to use during runner setup.
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.
Defaults to false. Prevent sharing a project with another group within this group.
Defaults to owner. Allowed to create subgroups.
Defaults to 48. Time before Two-factor authentication is enforced (in hours).
The group's visibility. Can be private
, internal
, or public
.