gitlab.UserRunner
Explore with Pulumi AI
The gitlab.UserRunner
resource allows creating a GitLab runner using the new GitLab Runner Registration Flow.
Upstream API: GitLab REST API docs
Create UserRunner Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new UserRunner(name: string, args: UserRunnerArgs, opts?: CustomResourceOptions);
@overload
def UserRunner(resource_name: str,
args: UserRunnerArgs,
opts: Optional[ResourceOptions] = None)
@overload
def UserRunner(resource_name: str,
opts: Optional[ResourceOptions] = None,
runner_type: Optional[str] = None,
access_level: Optional[str] = None,
description: Optional[str] = None,
group_id: Optional[int] = None,
locked: Optional[bool] = None,
maximum_timeout: Optional[int] = None,
paused: Optional[bool] = None,
project_id: Optional[int] = None,
tag_lists: Optional[Sequence[str]] = None,
untagged: Optional[bool] = None)
func NewUserRunner(ctx *Context, name string, args UserRunnerArgs, opts ...ResourceOption) (*UserRunner, error)
public UserRunner(string name, UserRunnerArgs args, CustomResourceOptions? opts = null)
public UserRunner(String name, UserRunnerArgs args)
public UserRunner(String name, UserRunnerArgs args, CustomResourceOptions options)
type: gitlab:UserRunner
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args UserRunnerArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args UserRunnerArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args UserRunnerArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args UserRunnerArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args UserRunnerArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Example
The following reference example uses placeholder values for all input properties.
var userRunnerResource = new GitLab.UserRunner("userRunnerResource", new()
{
RunnerType = "string",
AccessLevel = "string",
Description = "string",
GroupId = 0,
Locked = false,
MaximumTimeout = 0,
Paused = false,
ProjectId = 0,
TagLists = new[]
{
"string",
},
Untagged = false,
});
example, err := gitlab.NewUserRunner(ctx, "userRunnerResource", &gitlab.UserRunnerArgs{
RunnerType: pulumi.String("string"),
AccessLevel: pulumi.String("string"),
Description: pulumi.String("string"),
GroupId: pulumi.Int(0),
Locked: pulumi.Bool(false),
MaximumTimeout: pulumi.Int(0),
Paused: pulumi.Bool(false),
ProjectId: pulumi.Int(0),
TagLists: pulumi.StringArray{
pulumi.String("string"),
},
Untagged: pulumi.Bool(false),
})
var userRunnerResource = new UserRunner("userRunnerResource", UserRunnerArgs.builder()
.runnerType("string")
.accessLevel("string")
.description("string")
.groupId(0)
.locked(false)
.maximumTimeout(0)
.paused(false)
.projectId(0)
.tagLists("string")
.untagged(false)
.build());
user_runner_resource = gitlab.UserRunner("userRunnerResource",
runner_type="string",
access_level="string",
description="string",
group_id=0,
locked=False,
maximum_timeout=0,
paused=False,
project_id=0,
tag_lists=["string"],
untagged=False)
const userRunnerResource = new gitlab.UserRunner("userRunnerResource", {
runnerType: "string",
accessLevel: "string",
description: "string",
groupId: 0,
locked: false,
maximumTimeout: 0,
paused: false,
projectId: 0,
tagLists: ["string"],
untagged: false,
});
type: gitlab:UserRunner
properties:
accessLevel: string
description: string
groupId: 0
locked: false
maximumTimeout: 0
paused: false
projectId: 0
runnerType: string
tagLists:
- string
untagged: false
UserRunner Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The UserRunner resource accepts the following input properties:
- Runner
Type string - The scope of the runner. Valid values are:
instance_type
,group_type
,project_type
. - Access
Level string - The access level of the runner. Valid values are:
not_protected
,ref_protected
. - Description string
- Description of the runner.
- Group
Id int - The ID of the group that the runner is created in. Required if runnertype is grouptype.
- Locked bool
- Specifies if the runner should be locked for the current project.
- Maximum
Timeout int - Maximum timeout that limits the amount of time (in seconds) that runners can run jobs. Must be at least 600 (10 minutes).
- Paused bool
- Specifies if the runner should ignore new jobs.
- Project
Id int - The ID of the project that the runner is created in. Required if runnertype is projecttype.
- Tag
Lists List<string> - A list of runner tags.
- Untagged bool
- Specifies if the runner should handle untagged jobs.
- Runner
Type string - The scope of the runner. Valid values are:
instance_type
,group_type
,project_type
. - Access
Level string - The access level of the runner. Valid values are:
not_protected
,ref_protected
. - Description string
- Description of the runner.
- Group
Id int - The ID of the group that the runner is created in. Required if runnertype is grouptype.
- Locked bool
- Specifies if the runner should be locked for the current project.
- Maximum
Timeout int - Maximum timeout that limits the amount of time (in seconds) that runners can run jobs. Must be at least 600 (10 minutes).
- Paused bool
- Specifies if the runner should ignore new jobs.
- Project
Id int - The ID of the project that the runner is created in. Required if runnertype is projecttype.
- Tag
Lists []string - A list of runner tags.
- Untagged bool
- Specifies if the runner should handle untagged jobs.
- runner
Type String - The scope of the runner. Valid values are:
instance_type
,group_type
,project_type
. - access
Level String - The access level of the runner. Valid values are:
not_protected
,ref_protected
. - description String
- Description of the runner.
- group
Id Integer - The ID of the group that the runner is created in. Required if runnertype is grouptype.
- locked Boolean
- Specifies if the runner should be locked for the current project.
- maximum
Timeout Integer - Maximum timeout that limits the amount of time (in seconds) that runners can run jobs. Must be at least 600 (10 minutes).
- paused Boolean
- Specifies if the runner should ignore new jobs.
- project
Id Integer - The ID of the project that the runner is created in. Required if runnertype is projecttype.
- tag
Lists List<String> - A list of runner tags.
- untagged Boolean
- Specifies if the runner should handle untagged jobs.
- runner
Type string - The scope of the runner. Valid values are:
instance_type
,group_type
,project_type
. - access
Level string - The access level of the runner. Valid values are:
not_protected
,ref_protected
. - description string
- Description of the runner.
- group
Id number - The ID of the group that the runner is created in. Required if runnertype is grouptype.
- locked boolean
- Specifies if the runner should be locked for the current project.
- maximum
Timeout number - Maximum timeout that limits the amount of time (in seconds) that runners can run jobs. Must be at least 600 (10 minutes).
- paused boolean
- Specifies if the runner should ignore new jobs.
- project
Id number - The ID of the project that the runner is created in. Required if runnertype is projecttype.
- tag
Lists string[] - A list of runner tags.
- untagged boolean
- Specifies if the runner should handle untagged jobs.
- runner_
type str - The scope of the runner. Valid values are:
instance_type
,group_type
,project_type
. - access_
level str - The access level of the runner. Valid values are:
not_protected
,ref_protected
. - description str
- Description of the runner.
- group_
id int - The ID of the group that the runner is created in. Required if runnertype is grouptype.
- locked bool
- Specifies if the runner should be locked for the current project.
- maximum_
timeout int - Maximum timeout that limits the amount of time (in seconds) that runners can run jobs. Must be at least 600 (10 minutes).
- paused bool
- Specifies if the runner should ignore new jobs.
- project_
id int - The ID of the project that the runner is created in. Required if runnertype is projecttype.
- tag_
lists Sequence[str] - A list of runner tags.
- untagged bool
- Specifies if the runner should handle untagged jobs.
- runner
Type String - The scope of the runner. Valid values are:
instance_type
,group_type
,project_type
. - access
Level String - The access level of the runner. Valid values are:
not_protected
,ref_protected
. - description String
- Description of the runner.
- group
Id Number - The ID of the group that the runner is created in. Required if runnertype is grouptype.
- locked Boolean
- Specifies if the runner should be locked for the current project.
- maximum
Timeout Number - Maximum timeout that limits the amount of time (in seconds) that runners can run jobs. Must be at least 600 (10 minutes).
- paused Boolean
- Specifies if the runner should ignore new jobs.
- project
Id Number - The ID of the project that the runner is created in. Required if runnertype is projecttype.
- tag
Lists List<String> - A list of runner tags.
- untagged Boolean
- Specifies if the runner should handle untagged jobs.
Outputs
All input properties are implicitly available as output properties. Additionally, the UserRunner resource produces the following output properties:
Look up Existing UserRunner Resource
Get an existing UserRunner resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: UserRunnerState, opts?: CustomResourceOptions): UserRunner
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
access_level: Optional[str] = None,
description: Optional[str] = None,
group_id: Optional[int] = None,
locked: Optional[bool] = None,
maximum_timeout: Optional[int] = None,
paused: Optional[bool] = None,
project_id: Optional[int] = None,
runner_type: Optional[str] = None,
tag_lists: Optional[Sequence[str]] = None,
token: Optional[str] = None,
untagged: Optional[bool] = None) -> UserRunner
func GetUserRunner(ctx *Context, name string, id IDInput, state *UserRunnerState, opts ...ResourceOption) (*UserRunner, error)
public static UserRunner Get(string name, Input<string> id, UserRunnerState? state, CustomResourceOptions? opts = null)
public static UserRunner get(String name, Output<String> id, UserRunnerState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Access
Level string - The access level of the runner. Valid values are:
not_protected
,ref_protected
. - Description string
- Description of the runner.
- Group
Id int - The ID of the group that the runner is created in. Required if runnertype is grouptype.
- Locked bool
- Specifies if the runner should be locked for the current project.
- Maximum
Timeout int - Maximum timeout that limits the amount of time (in seconds) that runners can run jobs. Must be at least 600 (10 minutes).
- Paused bool
- Specifies if the runner should ignore new jobs.
- Project
Id int - The ID of the project that the runner is created in. Required if runnertype is projecttype.
- Runner
Type string - The scope of the runner. Valid values are:
instance_type
,group_type
,project_type
. - Tag
Lists List<string> - A list of runner tags.
- Token string
- The authentication token to use when setting up a new runner with this configuration. This value cannot be imported.
- Untagged bool
- Specifies if the runner should handle untagged jobs.
- Access
Level string - The access level of the runner. Valid values are:
not_protected
,ref_protected
. - Description string
- Description of the runner.
- Group
Id int - The ID of the group that the runner is created in. Required if runnertype is grouptype.
- Locked bool
- Specifies if the runner should be locked for the current project.
- Maximum
Timeout int - Maximum timeout that limits the amount of time (in seconds) that runners can run jobs. Must be at least 600 (10 minutes).
- Paused bool
- Specifies if the runner should ignore new jobs.
- Project
Id int - The ID of the project that the runner is created in. Required if runnertype is projecttype.
- Runner
Type string - The scope of the runner. Valid values are:
instance_type
,group_type
,project_type
. - Tag
Lists []string - A list of runner tags.
- Token string
- The authentication token to use when setting up a new runner with this configuration. This value cannot be imported.
- Untagged bool
- Specifies if the runner should handle untagged jobs.
- access
Level String - The access level of the runner. Valid values are:
not_protected
,ref_protected
. - description String
- Description of the runner.
- group
Id Integer - The ID of the group that the runner is created in. Required if runnertype is grouptype.
- locked Boolean
- Specifies if the runner should be locked for the current project.
- maximum
Timeout Integer - Maximum timeout that limits the amount of time (in seconds) that runners can run jobs. Must be at least 600 (10 minutes).
- paused Boolean
- Specifies if the runner should ignore new jobs.
- project
Id Integer - The ID of the project that the runner is created in. Required if runnertype is projecttype.
- runner
Type String - The scope of the runner. Valid values are:
instance_type
,group_type
,project_type
. - tag
Lists List<String> - A list of runner tags.
- token String
- The authentication token to use when setting up a new runner with this configuration. This value cannot be imported.
- untagged Boolean
- Specifies if the runner should handle untagged jobs.
- access
Level string - The access level of the runner. Valid values are:
not_protected
,ref_protected
. - description string
- Description of the runner.
- group
Id number - The ID of the group that the runner is created in. Required if runnertype is grouptype.
- locked boolean
- Specifies if the runner should be locked for the current project.
- maximum
Timeout number - Maximum timeout that limits the amount of time (in seconds) that runners can run jobs. Must be at least 600 (10 minutes).
- paused boolean
- Specifies if the runner should ignore new jobs.
- project
Id number - The ID of the project that the runner is created in. Required if runnertype is projecttype.
- runner
Type string - The scope of the runner. Valid values are:
instance_type
,group_type
,project_type
. - tag
Lists string[] - A list of runner tags.
- token string
- The authentication token to use when setting up a new runner with this configuration. This value cannot be imported.
- untagged boolean
- Specifies if the runner should handle untagged jobs.
- access_
level str - The access level of the runner. Valid values are:
not_protected
,ref_protected
. - description str
- Description of the runner.
- group_
id int - The ID of the group that the runner is created in. Required if runnertype is grouptype.
- locked bool
- Specifies if the runner should be locked for the current project.
- maximum_
timeout int - Maximum timeout that limits the amount of time (in seconds) that runners can run jobs. Must be at least 600 (10 minutes).
- paused bool
- Specifies if the runner should ignore new jobs.
- project_
id int - The ID of the project that the runner is created in. Required if runnertype is projecttype.
- runner_
type str - The scope of the runner. Valid values are:
instance_type
,group_type
,project_type
. - tag_
lists Sequence[str] - A list of runner tags.
- token str
- The authentication token to use when setting up a new runner with this configuration. This value cannot be imported.
- untagged bool
- Specifies if the runner should handle untagged jobs.
- access
Level String - The access level of the runner. Valid values are:
not_protected
,ref_protected
. - description String
- Description of the runner.
- group
Id Number - The ID of the group that the runner is created in. Required if runnertype is grouptype.
- locked Boolean
- Specifies if the runner should be locked for the current project.
- maximum
Timeout Number - Maximum timeout that limits the amount of time (in seconds) that runners can run jobs. Must be at least 600 (10 minutes).
- paused Boolean
- Specifies if the runner should ignore new jobs.
- project
Id Number - The ID of the project that the runner is created in. Required if runnertype is projecttype.
- runner
Type String - The scope of the runner. Valid values are:
instance_type
,group_type
,project_type
. - tag
Lists List<String> - A list of runner tags.
- token String
- The authentication token to use when setting up a new runner with this configuration. This value cannot be imported.
- untagged Boolean
- Specifies if the runner should handle untagged jobs.
Package Details
- Repository
- GitLab pulumi/pulumi-gitlab
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
gitlab
Terraform Provider.