GitLab v8.5.0 published on Friday, Oct 18, 2024 by Pulumi
gitlab.getProject
Explore with Pulumi AI
The gitlab.Project
data source allows details of a project to be retrieved by either its ID or its path with namespace.
Upstream API: GitLab REST API docs
Using getProject
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getProject(args: GetProjectArgs, opts?: InvokeOptions): Promise<GetProjectResult>
function getProjectOutput(args: GetProjectOutputArgs, opts?: InvokeOptions): Output<GetProjectResult>
def get_project(ci_default_git_depth: Optional[int] = None,
id: Optional[str] = None,
path_with_namespace: Optional[str] = None,
public_builds: Optional[bool] = None,
opts: Optional[InvokeOptions] = None) -> GetProjectResult
def get_project_output(ci_default_git_depth: Optional[pulumi.Input[int]] = None,
id: Optional[pulumi.Input[str]] = None,
path_with_namespace: Optional[pulumi.Input[str]] = None,
public_builds: Optional[pulumi.Input[bool]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetProjectResult]
func LookupProject(ctx *Context, args *LookupProjectArgs, opts ...InvokeOption) (*LookupProjectResult, error)
func LookupProjectOutput(ctx *Context, args *LookupProjectOutputArgs, opts ...InvokeOption) LookupProjectResultOutput
> Note: This function is named LookupProject
in the Go SDK.
public static class GetProject
{
public static Task<GetProjectResult> InvokeAsync(GetProjectArgs args, InvokeOptions? opts = null)
public static Output<GetProjectResult> Invoke(GetProjectInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetProjectResult> getProject(GetProjectArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: gitlab:index/getProject:getProject
arguments:
# arguments dictionary
The following arguments are supported:
- Ci
Default intGit Depth - Default number of revisions for shallow cloning.
- Id string
- The integer that uniquely identifies the project within the gitlab install.
- Path
With stringNamespace - The path of the repository with namespace.
- Public
Builds bool - If true, jobs can be viewed by non-project members.
- Ci
Default intGit Depth - Default number of revisions for shallow cloning.
- Id string
- The integer that uniquely identifies the project within the gitlab install.
- Path
With stringNamespace - The path of the repository with namespace.
- Public
Builds bool - If true, jobs can be viewed by non-project members.
- ci
Default IntegerGit Depth - Default number of revisions for shallow cloning.
- id String
- The integer that uniquely identifies the project within the gitlab install.
- path
With StringNamespace - The path of the repository with namespace.
- public
Builds Boolean - If true, jobs can be viewed by non-project members.
- ci
Default numberGit Depth - Default number of revisions for shallow cloning.
- id string
- The integer that uniquely identifies the project within the gitlab install.
- path
With stringNamespace - The path of the repository with namespace.
- public
Builds boolean - If true, jobs can be viewed by non-project members.
- ci_
default_ intgit_ depth - Default number of revisions for shallow cloning.
- id str
- The integer that uniquely identifies the project within the gitlab install.
- path_
with_ strnamespace - The path of the repository with namespace.
- public_
builds bool - If true, jobs can be viewed by non-project members.
- ci
Default NumberGit Depth - Default number of revisions for shallow cloning.
- id String
- The integer that uniquely identifies the project within the gitlab install.
- path
With StringNamespace - The path of the repository with namespace.
- public
Builds Boolean - If true, jobs can be viewed by non-project members.
getProject Result
The following output properties are available:
- Allow
Pipeline boolTrigger Approve Deployment - Set whether or not a pipeline triggerer is allowed to approve deployments. Premium and Ultimate only.
- Analytics
Access stringLevel - Set the analytics access level. Valid values are
disabled
,private
,enabled
. - Archived bool
- Whether the project is in read-only mode (archived).
- Auto
Cancel stringPending Pipelines - Auto-cancel pending pipelines. This isn’t a boolean, but enabled/disabled.
- Auto
Devops stringDeploy Strategy - Auto Deploy strategy. Valid values are
continuous
,manual
,timed_incremental
. - Auto
Devops boolEnabled - Enable Auto DevOps for this project.
- Autoclose
Referenced boolIssues - Set whether auto-closing referenced issues on default branch.
- Build
Git stringStrategy - The Git strategy. Defaults to fetch.
- Build
Timeout int - The maximum amount of time, in seconds, that a job can run.
- Builds
Access stringLevel - Set the builds access level. Valid values are
disabled
,private
,enabled
. - Ci
Config stringPath - CI config file path for the project.
- Ci
Default intGit Depth - Default number of revisions for shallow cloning.
- Ci
Restrict stringPipeline Cancellation Role - The role required to cancel a pipeline or job. Introduced in GitLab 16.8. Premium and Ultimate only. Valid values are
developer
,maintainer
,no one
- Ci
Separated boolCaches - Use separate caches for protected branches.
- Container
Expiration List<Pulumi.Policies Git Lab. Outputs. Get Project Container Expiration Policy> - Set the image cleanup policy for this project. Note: this field is sometimes named
container_expiration_policy_attributes
in the GitLab Upstream API. - Container
Registry stringAccess Level - Set visibility of container registry, for this project. Valid values are
disabled
,private
,enabled
. - Default
Branch string - The default branch for the project.
- Description string
- A description of the project.
- Emails
Enabled bool - Enable email notifications.
- Empty
Repo bool - Whether the project is empty.
- Environments
Access stringLevel - Set the environments access level. Valid values are
disabled
,private
,enabled
. - string
- The classification label for the project.
- Feature
Flags stringAccess Level - Set the feature flags access level. Valid values are
disabled
,private
,enabled
. - Forking
Access stringLevel - Set the forking access level. Valid values are
disabled
,private
,enabled
. - Http
Url stringTo Repo - URL that can be provided to
git clone
to clone the - Id string
- The integer that uniquely identifies the project within the gitlab install.
- Import
Url string - URL the project was imported from.
- Infrastructure
Access stringLevel - Set the infrastructure access level. Valid values are
disabled
,private
,enabled
. - Issues
Access stringLevel - Set the issues access level. Valid values are
disabled
,private
,enabled
. - Issues
Enabled bool - Enable issue tracking for the project.
- Keep
Latest boolArtifact - Disable or enable the ability to keep the latest artifact for this project.
- Lfs
Enabled bool - Enable LFS for the project.
- Merge
Commit stringTemplate - Template used to create merge commit message in merge requests. (Introduced in GitLab 14.5.)
- Merge
Pipelines boolEnabled - Enable or disable merge pipelines.
- Merge
Requests stringAccess Level - Set the merge requests access level. Valid values are
disabled
,private
,enabled
. - Merge
Requests boolEnabled - Enable merge requests for the project.
- Merge
Trains boolEnabled - Enable or disable merge trains.
- Model
Experiments stringAccess Level - The visibility of machine learning model experiments.
- Model
Registry stringAccess Level - The visibility of machine learning model registry.
- Monitor
Access stringLevel - Set the monitor access level. Valid values are
disabled
,private
,enabled
. - Name string
- The name of the project.
- Namespace
Id int - The namespace (group or user) of the project. Defaults to your user.
- Path string
- The path of the repository.
- Path
With stringNamespace - The path of the repository with namespace.
- Pipelines
Enabled bool - Enable pipelines for the project.
- Printing
Merge boolRequest Link Enabled - Show link to create/view merge request when pushing from the command line
- Push
Rules List<Pulumi.Git Lab. Outputs. Get Project Push Rule> - Push rules for the project. Push rules are only available on Enterprise plans and if the authenticated has permissions to read them.
- Releases
Access stringLevel - Set the releases access level. Valid values are
disabled
,private
,enabled
. - Remove
Source boolBranch After Merge - Enable
Delete source branch
option by default for all new merge requests - Repository
Access stringLevel - Set the repository access level. Valid values are
disabled
,private
,enabled
. - Repository
Storage string - Which storage shard the repository is on. (administrator only)
- Request
Access boolEnabled - Allow users to request member access.
- Requirements
Access stringLevel - Set the requirements access level. Valid values are
disabled
,private
,enabled
. - Resolve
Outdated boolDiff Discussions - Automatically resolve merge request diffs discussions on lines changed with a push.
- Restrict
User boolDefined Variables - Allow only users with the Maintainer role to pass user-defined variables when triggering a pipeline.
- Runners
Token string - Registration token to use during runner setup.
- Security
And stringCompliance Access Level - Set the security and compliance access level. Valid values are
disabled
,private
,enabled
. - List<Pulumi.
Git Lab. Outputs. Get Project Shared With Group> - Describes groups which have access shared to this project.
- Snippets
Access stringLevel - Set the snippets access level. Valid values are
disabled
,private
,enabled
. - Snippets
Enabled bool - Enable snippets for the project.
- Squash
Commit stringTemplate - Template used to create squash commit message in merge requests. (Introduced in GitLab 14.6.)
- Ssh
Url stringTo Repo - URL that can be provided to
git clone
to clone the - Suggestion
Commit stringMessage - The commit message used to apply merge request suggestions.
- Topics List<string>
- The list of topics for the project.
- Visibility
Level string - Repositories are created as private by default.
- Web
Url string - URL that can be used to find the project in a browser.
- Wiki
Access stringLevel - Set the wiki access level. Valid values are
disabled
,private
,enabled
. - Wiki
Enabled bool - Enable wiki for the project.
- Public
Builds bool - If true, jobs can be viewed by non-project members.
- Allow
Pipeline boolTrigger Approve Deployment - Set whether or not a pipeline triggerer is allowed to approve deployments. Premium and Ultimate only.
- Analytics
Access stringLevel - Set the analytics access level. Valid values are
disabled
,private
,enabled
. - Archived bool
- Whether the project is in read-only mode (archived).
- Auto
Cancel stringPending Pipelines - Auto-cancel pending pipelines. This isn’t a boolean, but enabled/disabled.
- Auto
Devops stringDeploy Strategy - Auto Deploy strategy. Valid values are
continuous
,manual
,timed_incremental
. - Auto
Devops boolEnabled - Enable Auto DevOps for this project.
- Autoclose
Referenced boolIssues - Set whether auto-closing referenced issues on default branch.
- Build
Git stringStrategy - The Git strategy. Defaults to fetch.
- Build
Timeout int - The maximum amount of time, in seconds, that a job can run.
- Builds
Access stringLevel - Set the builds access level. Valid values are
disabled
,private
,enabled
. - Ci
Config stringPath - CI config file path for the project.
- Ci
Default intGit Depth - Default number of revisions for shallow cloning.
- Ci
Restrict stringPipeline Cancellation Role - The role required to cancel a pipeline or job. Introduced in GitLab 16.8. Premium and Ultimate only. Valid values are
developer
,maintainer
,no one
- Ci
Separated boolCaches - Use separate caches for protected branches.
- Container
Expiration []GetPolicies Project Container Expiration Policy - Set the image cleanup policy for this project. Note: this field is sometimes named
container_expiration_policy_attributes
in the GitLab Upstream API. - Container
Registry stringAccess Level - Set visibility of container registry, for this project. Valid values are
disabled
,private
,enabled
. - Default
Branch string - The default branch for the project.
- Description string
- A description of the project.
- Emails
Enabled bool - Enable email notifications.
- Empty
Repo bool - Whether the project is empty.
- Environments
Access stringLevel - Set the environments access level. Valid values are
disabled
,private
,enabled
. - string
- The classification label for the project.
- Feature
Flags stringAccess Level - Set the feature flags access level. Valid values are
disabled
,private
,enabled
. - Forking
Access stringLevel - Set the forking access level. Valid values are
disabled
,private
,enabled
. - Http
Url stringTo Repo - URL that can be provided to
git clone
to clone the - Id string
- The integer that uniquely identifies the project within the gitlab install.
- Import
Url string - URL the project was imported from.
- Infrastructure
Access stringLevel - Set the infrastructure access level. Valid values are
disabled
,private
,enabled
. - Issues
Access stringLevel - Set the issues access level. Valid values are
disabled
,private
,enabled
. - Issues
Enabled bool - Enable issue tracking for the project.
- Keep
Latest boolArtifact - Disable or enable the ability to keep the latest artifact for this project.
- Lfs
Enabled bool - Enable LFS for the project.
- Merge
Commit stringTemplate - Template used to create merge commit message in merge requests. (Introduced in GitLab 14.5.)
- Merge
Pipelines boolEnabled - Enable or disable merge pipelines.
- Merge
Requests stringAccess Level - Set the merge requests access level. Valid values are
disabled
,private
,enabled
. - Merge
Requests boolEnabled - Enable merge requests for the project.
- Merge
Trains boolEnabled - Enable or disable merge trains.
- Model
Experiments stringAccess Level - The visibility of machine learning model experiments.
- Model
Registry stringAccess Level - The visibility of machine learning model registry.
- Monitor
Access stringLevel - Set the monitor access level. Valid values are
disabled
,private
,enabled
. - Name string
- The name of the project.
- Namespace
Id int - The namespace (group or user) of the project. Defaults to your user.
- Path string
- The path of the repository.
- Path
With stringNamespace - The path of the repository with namespace.
- Pipelines
Enabled bool - Enable pipelines for the project.
- Printing
Merge boolRequest Link Enabled - Show link to create/view merge request when pushing from the command line
- Push
Rules []GetProject Push Rule - Push rules for the project. Push rules are only available on Enterprise plans and if the authenticated has permissions to read them.
- Releases
Access stringLevel - Set the releases access level. Valid values are
disabled
,private
,enabled
. - Remove
Source boolBranch After Merge - Enable
Delete source branch
option by default for all new merge requests - Repository
Access stringLevel - Set the repository access level. Valid values are
disabled
,private
,enabled
. - Repository
Storage string - Which storage shard the repository is on. (administrator only)
- Request
Access boolEnabled - Allow users to request member access.
- Requirements
Access stringLevel - Set the requirements access level. Valid values are
disabled
,private
,enabled
. - Resolve
Outdated boolDiff Discussions - Automatically resolve merge request diffs discussions on lines changed with a push.
- Restrict
User boolDefined Variables - Allow only users with the Maintainer role to pass user-defined variables when triggering a pipeline.
- Runners
Token string - Registration token to use during runner setup.
- Security
And stringCompliance Access Level - Set the security and compliance access level. Valid values are
disabled
,private
,enabled
. - []Get
Project Shared With Group - Describes groups which have access shared to this project.
- Snippets
Access stringLevel - Set the snippets access level. Valid values are
disabled
,private
,enabled
. - Snippets
Enabled bool - Enable snippets for the project.
- Squash
Commit stringTemplate - Template used to create squash commit message in merge requests. (Introduced in GitLab 14.6.)
- Ssh
Url stringTo Repo - URL that can be provided to
git clone
to clone the - Suggestion
Commit stringMessage - The commit message used to apply merge request suggestions.
- Topics []string
- The list of topics for the project.
- Visibility
Level string - Repositories are created as private by default.
- Web
Url string - URL that can be used to find the project in a browser.
- Wiki
Access stringLevel - Set the wiki access level. Valid values are
disabled
,private
,enabled
. - Wiki
Enabled bool - Enable wiki for the project.
- Public
Builds bool - If true, jobs can be viewed by non-project members.
- allow
Pipeline BooleanTrigger Approve Deployment - Set whether or not a pipeline triggerer is allowed to approve deployments. Premium and Ultimate only.
- analytics
Access StringLevel - Set the analytics access level. Valid values are
disabled
,private
,enabled
. - archived Boolean
- Whether the project is in read-only mode (archived).
- auto
Cancel StringPending Pipelines - Auto-cancel pending pipelines. This isn’t a boolean, but enabled/disabled.
- auto
Devops StringDeploy Strategy - Auto Deploy strategy. Valid values are
continuous
,manual
,timed_incremental
. - auto
Devops BooleanEnabled - Enable Auto DevOps for this project.
- autoclose
Referenced BooleanIssues - Set whether auto-closing referenced issues on default branch.
- build
Git StringStrategy - The Git strategy. Defaults to fetch.
- build
Timeout Integer - The maximum amount of time, in seconds, that a job can run.
- builds
Access StringLevel - Set the builds access level. Valid values are
disabled
,private
,enabled
. - ci
Config StringPath - CI config file path for the project.
- ci
Default IntegerGit Depth - Default number of revisions for shallow cloning.
- ci
Restrict StringPipeline Cancellation Role - The role required to cancel a pipeline or job. Introduced in GitLab 16.8. Premium and Ultimate only. Valid values are
developer
,maintainer
,no one
- ci
Separated BooleanCaches - Use separate caches for protected branches.
- container
Expiration List<GetPolicies Project Container Expiration Policy> - Set the image cleanup policy for this project. Note: this field is sometimes named
container_expiration_policy_attributes
in the GitLab Upstream API. - container
Registry StringAccess Level - Set visibility of container registry, for this project. Valid values are
disabled
,private
,enabled
. - default
Branch String - The default branch for the project.
- description String
- A description of the project.
- emails
Enabled Boolean - Enable email notifications.
- empty
Repo Boolean - Whether the project is empty.
- environments
Access StringLevel - Set the environments access level. Valid values are
disabled
,private
,enabled
. - String
- The classification label for the project.
- feature
Flags StringAccess Level - Set the feature flags access level. Valid values are
disabled
,private
,enabled
. - forking
Access StringLevel - Set the forking access level. Valid values are
disabled
,private
,enabled
. - http
Url StringTo Repo - URL that can be provided to
git clone
to clone the - id String
- The integer that uniquely identifies the project within the gitlab install.
- import
Url String - URL the project was imported from.
- infrastructure
Access StringLevel - Set the infrastructure access level. Valid values are
disabled
,private
,enabled
. - issues
Access StringLevel - Set the issues access level. Valid values are
disabled
,private
,enabled
. - issues
Enabled Boolean - Enable issue tracking for the project.
- keep
Latest BooleanArtifact - Disable or enable the ability to keep the latest artifact for this project.
- lfs
Enabled Boolean - Enable LFS for the project.
- merge
Commit StringTemplate - Template used to create merge commit message in merge requests. (Introduced in GitLab 14.5.)
- merge
Pipelines BooleanEnabled - Enable or disable merge pipelines.
- merge
Requests StringAccess Level - Set the merge requests access level. Valid values are
disabled
,private
,enabled
. - merge
Requests BooleanEnabled - Enable merge requests for the project.
- merge
Trains BooleanEnabled - Enable or disable merge trains.
- model
Experiments StringAccess Level - The visibility of machine learning model experiments.
- model
Registry StringAccess Level - The visibility of machine learning model registry.
- monitor
Access StringLevel - Set the monitor access level. Valid values are
disabled
,private
,enabled
. - name String
- The name of the project.
- namespace
Id Integer - The namespace (group or user) of the project. Defaults to your user.
- path String
- The path of the repository.
- path
With StringNamespace - The path of the repository with namespace.
- pipelines
Enabled Boolean - Enable pipelines for the project.
- printing
Merge BooleanRequest Link Enabled - Show link to create/view merge request when pushing from the command line
- push
Rules List<GetProject Push Rule> - Push rules for the project. Push rules are only available on Enterprise plans and if the authenticated has permissions to read them.
- releases
Access StringLevel - Set the releases access level. Valid values are
disabled
,private
,enabled
. - remove
Source BooleanBranch After Merge - Enable
Delete source branch
option by default for all new merge requests - repository
Access StringLevel - Set the repository access level. Valid values are
disabled
,private
,enabled
. - repository
Storage String - Which storage shard the repository is on. (administrator only)
- request
Access BooleanEnabled - Allow users to request member access.
- requirements
Access StringLevel - Set the requirements access level. Valid values are
disabled
,private
,enabled
. - resolve
Outdated BooleanDiff Discussions - Automatically resolve merge request diffs discussions on lines changed with a push.
- restrict
User BooleanDefined Variables - Allow only users with the Maintainer role to pass user-defined variables when triggering a pipeline.
- runners
Token String - Registration token to use during runner setup.
- security
And StringCompliance Access Level - Set the security and compliance access level. Valid values are
disabled
,private
,enabled
. - List<Get
Project Shared With Group> - Describes groups which have access shared to this project.
- snippets
Access StringLevel - Set the snippets access level. Valid values are
disabled
,private
,enabled
. - snippets
Enabled Boolean - Enable snippets for the project.
- squash
Commit StringTemplate - Template used to create squash commit message in merge requests. (Introduced in GitLab 14.6.)
- ssh
Url StringTo Repo - URL that can be provided to
git clone
to clone the - suggestion
Commit StringMessage - The commit message used to apply merge request suggestions.
- topics List<String>
- The list of topics for the project.
- visibility
Level String - Repositories are created as private by default.
- web
Url String - URL that can be used to find the project in a browser.
- wiki
Access StringLevel - Set the wiki access level. Valid values are
disabled
,private
,enabled
. - wiki
Enabled Boolean - Enable wiki for the project.
- public
Builds Boolean - If true, jobs can be viewed by non-project members.
- allow
Pipeline booleanTrigger Approve Deployment - Set whether or not a pipeline triggerer is allowed to approve deployments. Premium and Ultimate only.
- analytics
Access stringLevel - Set the analytics access level. Valid values are
disabled
,private
,enabled
. - archived boolean
- Whether the project is in read-only mode (archived).
- auto
Cancel stringPending Pipelines - Auto-cancel pending pipelines. This isn’t a boolean, but enabled/disabled.
- auto
Devops stringDeploy Strategy - Auto Deploy strategy. Valid values are
continuous
,manual
,timed_incremental
. - auto
Devops booleanEnabled - Enable Auto DevOps for this project.
- autoclose
Referenced booleanIssues - Set whether auto-closing referenced issues on default branch.
- build
Git stringStrategy - The Git strategy. Defaults to fetch.
- build
Timeout number - The maximum amount of time, in seconds, that a job can run.
- builds
Access stringLevel - Set the builds access level. Valid values are
disabled
,private
,enabled
. - ci
Config stringPath - CI config file path for the project.
- ci
Default numberGit Depth - Default number of revisions for shallow cloning.
- ci
Restrict stringPipeline Cancellation Role - The role required to cancel a pipeline or job. Introduced in GitLab 16.8. Premium and Ultimate only. Valid values are
developer
,maintainer
,no one
- ci
Separated booleanCaches - Use separate caches for protected branches.
- container
Expiration GetPolicies Project Container Expiration Policy[] - Set the image cleanup policy for this project. Note: this field is sometimes named
container_expiration_policy_attributes
in the GitLab Upstream API. - container
Registry stringAccess Level - Set visibility of container registry, for this project. Valid values are
disabled
,private
,enabled
. - default
Branch string - The default branch for the project.
- description string
- A description of the project.
- emails
Enabled boolean - Enable email notifications.
- empty
Repo boolean - Whether the project is empty.
- environments
Access stringLevel - Set the environments access level. Valid values are
disabled
,private
,enabled
. - string
- The classification label for the project.
- feature
Flags stringAccess Level - Set the feature flags access level. Valid values are
disabled
,private
,enabled
. - forking
Access stringLevel - Set the forking access level. Valid values are
disabled
,private
,enabled
. - http
Url stringTo Repo - URL that can be provided to
git clone
to clone the - id string
- The integer that uniquely identifies the project within the gitlab install.
- import
Url string - URL the project was imported from.
- infrastructure
Access stringLevel - Set the infrastructure access level. Valid values are
disabled
,private
,enabled
. - issues
Access stringLevel - Set the issues access level. Valid values are
disabled
,private
,enabled
. - issues
Enabled boolean - Enable issue tracking for the project.
- keep
Latest booleanArtifact - Disable or enable the ability to keep the latest artifact for this project.
- lfs
Enabled boolean - Enable LFS for the project.
- merge
Commit stringTemplate - Template used to create merge commit message in merge requests. (Introduced in GitLab 14.5.)
- merge
Pipelines booleanEnabled - Enable or disable merge pipelines.
- merge
Requests stringAccess Level - Set the merge requests access level. Valid values are
disabled
,private
,enabled
. - merge
Requests booleanEnabled - Enable merge requests for the project.
- merge
Trains booleanEnabled - Enable or disable merge trains.
- model
Experiments stringAccess Level - The visibility of machine learning model experiments.
- model
Registry stringAccess Level - The visibility of machine learning model registry.
- monitor
Access stringLevel - Set the monitor access level. Valid values are
disabled
,private
,enabled
. - name string
- The name of the project.
- namespace
Id number - The namespace (group or user) of the project. Defaults to your user.
- path string
- The path of the repository.
- path
With stringNamespace - The path of the repository with namespace.
- pipelines
Enabled boolean - Enable pipelines for the project.
- printing
Merge booleanRequest Link Enabled - Show link to create/view merge request when pushing from the command line
- push
Rules GetProject Push Rule[] - Push rules for the project. Push rules are only available on Enterprise plans and if the authenticated has permissions to read them.
- releases
Access stringLevel - Set the releases access level. Valid values are
disabled
,private
,enabled
. - remove
Source booleanBranch After Merge - Enable
Delete source branch
option by default for all new merge requests - repository
Access stringLevel - Set the repository access level. Valid values are
disabled
,private
,enabled
. - repository
Storage string - Which storage shard the repository is on. (administrator only)
- request
Access booleanEnabled - Allow users to request member access.
- requirements
Access stringLevel - Set the requirements access level. Valid values are
disabled
,private
,enabled
. - resolve
Outdated booleanDiff Discussions - Automatically resolve merge request diffs discussions on lines changed with a push.
- restrict
User booleanDefined Variables - Allow only users with the Maintainer role to pass user-defined variables when triggering a pipeline.
- runners
Token string - Registration token to use during runner setup.
- security
And stringCompliance Access Level - Set the security and compliance access level. Valid values are
disabled
,private
,enabled
. - Get
Project Shared With Group[] - Describes groups which have access shared to this project.
- snippets
Access stringLevel - Set the snippets access level. Valid values are
disabled
,private
,enabled
. - snippets
Enabled boolean - Enable snippets for the project.
- squash
Commit stringTemplate - Template used to create squash commit message in merge requests. (Introduced in GitLab 14.6.)
- ssh
Url stringTo Repo - URL that can be provided to
git clone
to clone the - suggestion
Commit stringMessage - The commit message used to apply merge request suggestions.
- topics string[]
- The list of topics for the project.
- visibility
Level string - Repositories are created as private by default.
- web
Url string - URL that can be used to find the project in a browser.
- wiki
Access stringLevel - Set the wiki access level. Valid values are
disabled
,private
,enabled
. - wiki
Enabled boolean - Enable wiki for the project.
- public
Builds boolean - If true, jobs can be viewed by non-project members.
- allow_
pipeline_ booltrigger_ approve_ deployment - Set whether or not a pipeline triggerer is allowed to approve deployments. Premium and Ultimate only.
- analytics_
access_ strlevel - Set the analytics access level. Valid values are
disabled
,private
,enabled
. - archived bool
- Whether the project is in read-only mode (archived).
- auto_
cancel_ strpending_ pipelines - Auto-cancel pending pipelines. This isn’t a boolean, but enabled/disabled.
- auto_
devops_ strdeploy_ strategy - Auto Deploy strategy. Valid values are
continuous
,manual
,timed_incremental
. - auto_
devops_ boolenabled - Enable Auto DevOps for this project.
- autoclose_
referenced_ boolissues - Set whether auto-closing referenced issues on default branch.
- build_
git_ strstrategy - The Git strategy. Defaults to fetch.
- build_
timeout int - The maximum amount of time, in seconds, that a job can run.
- builds_
access_ strlevel - Set the builds access level. Valid values are
disabled
,private
,enabled
. - ci_
config_ strpath - CI config file path for the project.
- ci_
default_ intgit_ depth - Default number of revisions for shallow cloning.
- ci_
restrict_ strpipeline_ cancellation_ role - The role required to cancel a pipeline or job. Introduced in GitLab 16.8. Premium and Ultimate only. Valid values are
developer
,maintainer
,no one
- ci_
separated_ boolcaches - Use separate caches for protected branches.
- container_
expiration_ Sequence[Getpolicies Project Container Expiration Policy] - Set the image cleanup policy for this project. Note: this field is sometimes named
container_expiration_policy_attributes
in the GitLab Upstream API. - container_
registry_ straccess_ level - Set visibility of container registry, for this project. Valid values are
disabled
,private
,enabled
. - default_
branch str - The default branch for the project.
- description str
- A description of the project.
- emails_
enabled bool - Enable email notifications.
- empty_
repo bool - Whether the project is empty.
- environments_
access_ strlevel - Set the environments access level. Valid values are
disabled
,private
,enabled
. - str
- The classification label for the project.
- feature_
flags_ straccess_ level - Set the feature flags access level. Valid values are
disabled
,private
,enabled
. - forking_
access_ strlevel - Set the forking access level. Valid values are
disabled
,private
,enabled
. - http_
url_ strto_ repo - URL that can be provided to
git clone
to clone the - id str
- The integer that uniquely identifies the project within the gitlab install.
- import_
url str - URL the project was imported from.
- infrastructure_
access_ strlevel - Set the infrastructure access level. Valid values are
disabled
,private
,enabled
. - issues_
access_ strlevel - Set the issues access level. Valid values are
disabled
,private
,enabled
. - issues_
enabled bool - Enable issue tracking for the project.
- keep_
latest_ boolartifact - Disable or enable the ability to keep the latest artifact for this project.
- lfs_
enabled bool - Enable LFS for the project.
- merge_
commit_ strtemplate - Template used to create merge commit message in merge requests. (Introduced in GitLab 14.5.)
- merge_
pipelines_ boolenabled - Enable or disable merge pipelines.
- merge_
requests_ straccess_ level - Set the merge requests access level. Valid values are
disabled
,private
,enabled
. - merge_
requests_ boolenabled - Enable merge requests for the project.
- merge_
trains_ boolenabled - Enable or disable merge trains.
- model_
experiments_ straccess_ level - The visibility of machine learning model experiments.
- model_
registry_ straccess_ level - The visibility of machine learning model registry.
- monitor_
access_ strlevel - Set the monitor access level. Valid values are
disabled
,private
,enabled
. - name str
- The name of the project.
- namespace_
id int - The namespace (group or user) of the project. Defaults to your user.
- path str
- The path of the repository.
- path_
with_ strnamespace - The path of the repository with namespace.
- pipelines_
enabled bool - Enable pipelines for the project.
- printing_
merge_ boolrequest_ link_ enabled - Show link to create/view merge request when pushing from the command line
- push_
rules Sequence[GetProject Push Rule] - Push rules for the project. Push rules are only available on Enterprise plans and if the authenticated has permissions to read them.
- releases_
access_ strlevel - Set the releases access level. Valid values are
disabled
,private
,enabled
. - remove_
source_ boolbranch_ after_ merge - Enable
Delete source branch
option by default for all new merge requests - repository_
access_ strlevel - Set the repository access level. Valid values are
disabled
,private
,enabled
. - repository_
storage str - Which storage shard the repository is on. (administrator only)
- request_
access_ boolenabled - Allow users to request member access.
- requirements_
access_ strlevel - Set the requirements access level. Valid values are
disabled
,private
,enabled
. - resolve_
outdated_ booldiff_ discussions - Automatically resolve merge request diffs discussions on lines changed with a push.
- restrict_
user_ booldefined_ variables - Allow only users with the Maintainer role to pass user-defined variables when triggering a pipeline.
- runners_
token str - Registration token to use during runner setup.
- security_
and_ strcompliance_ access_ level - Set the security and compliance access level. Valid values are
disabled
,private
,enabled
. - Sequence[Get
Project Shared With Group] - Describes groups which have access shared to this project.
- snippets_
access_ strlevel - Set the snippets access level. Valid values are
disabled
,private
,enabled
. - snippets_
enabled bool - Enable snippets for the project.
- squash_
commit_ strtemplate - Template used to create squash commit message in merge requests. (Introduced in GitLab 14.6.)
- ssh_
url_ strto_ repo - URL that can be provided to
git clone
to clone the - suggestion_
commit_ strmessage - The commit message used to apply merge request suggestions.
- topics Sequence[str]
- The list of topics for the project.
- visibility_
level str - Repositories are created as private by default.
- web_
url str - URL that can be used to find the project in a browser.
- wiki_
access_ strlevel - Set the wiki access level. Valid values are
disabled
,private
,enabled
. - wiki_
enabled bool - Enable wiki for the project.
- public_
builds bool - If true, jobs can be viewed by non-project members.
- allow
Pipeline BooleanTrigger Approve Deployment - Set whether or not a pipeline triggerer is allowed to approve deployments. Premium and Ultimate only.
- analytics
Access StringLevel - Set the analytics access level. Valid values are
disabled
,private
,enabled
. - archived Boolean
- Whether the project is in read-only mode (archived).
- auto
Cancel StringPending Pipelines - Auto-cancel pending pipelines. This isn’t a boolean, but enabled/disabled.
- auto
Devops StringDeploy Strategy - Auto Deploy strategy. Valid values are
continuous
,manual
,timed_incremental
. - auto
Devops BooleanEnabled - Enable Auto DevOps for this project.
- autoclose
Referenced BooleanIssues - Set whether auto-closing referenced issues on default branch.
- build
Git StringStrategy - The Git strategy. Defaults to fetch.
- build
Timeout Number - The maximum amount of time, in seconds, that a job can run.
- builds
Access StringLevel - Set the builds access level. Valid values are
disabled
,private
,enabled
. - ci
Config StringPath - CI config file path for the project.
- ci
Default NumberGit Depth - Default number of revisions for shallow cloning.
- ci
Restrict StringPipeline Cancellation Role - The role required to cancel a pipeline or job. Introduced in GitLab 16.8. Premium and Ultimate only. Valid values are
developer
,maintainer
,no one
- ci
Separated BooleanCaches - Use separate caches for protected branches.
- container
Expiration List<Property Map>Policies - Set the image cleanup policy for this project. Note: this field is sometimes named
container_expiration_policy_attributes
in the GitLab Upstream API. - container
Registry StringAccess Level - Set visibility of container registry, for this project. Valid values are
disabled
,private
,enabled
. - default
Branch String - The default branch for the project.
- description String
- A description of the project.
- emails
Enabled Boolean - Enable email notifications.
- empty
Repo Boolean - Whether the project is empty.
- environments
Access StringLevel - Set the environments access level. Valid values are
disabled
,private
,enabled
. - String
- The classification label for the project.
- feature
Flags StringAccess Level - Set the feature flags access level. Valid values are
disabled
,private
,enabled
. - forking
Access StringLevel - Set the forking access level. Valid values are
disabled
,private
,enabled
. - http
Url StringTo Repo - URL that can be provided to
git clone
to clone the - id String
- The integer that uniquely identifies the project within the gitlab install.
- import
Url String - URL the project was imported from.
- infrastructure
Access StringLevel - Set the infrastructure access level. Valid values are
disabled
,private
,enabled
. - issues
Access StringLevel - Set the issues access level. Valid values are
disabled
,private
,enabled
. - issues
Enabled Boolean - Enable issue tracking for the project.
- keep
Latest BooleanArtifact - Disable or enable the ability to keep the latest artifact for this project.
- lfs
Enabled Boolean - Enable LFS for the project.
- merge
Commit StringTemplate - Template used to create merge commit message in merge requests. (Introduced in GitLab 14.5.)
- merge
Pipelines BooleanEnabled - Enable or disable merge pipelines.
- merge
Requests StringAccess Level - Set the merge requests access level. Valid values are
disabled
,private
,enabled
. - merge
Requests BooleanEnabled - Enable merge requests for the project.
- merge
Trains BooleanEnabled - Enable or disable merge trains.
- model
Experiments StringAccess Level - The visibility of machine learning model experiments.
- model
Registry StringAccess Level - The visibility of machine learning model registry.
- monitor
Access StringLevel - Set the monitor access level. Valid values are
disabled
,private
,enabled
. - name String
- The name of the project.
- namespace
Id Number - The namespace (group or user) of the project. Defaults to your user.
- path String
- The path of the repository.
- path
With StringNamespace - The path of the repository with namespace.
- pipelines
Enabled Boolean - Enable pipelines for the project.
- printing
Merge BooleanRequest Link Enabled - Show link to create/view merge request when pushing from the command line
- push
Rules List<Property Map> - Push rules for the project. Push rules are only available on Enterprise plans and if the authenticated has permissions to read them.
- releases
Access StringLevel - Set the releases access level. Valid values are
disabled
,private
,enabled
. - remove
Source BooleanBranch After Merge - Enable
Delete source branch
option by default for all new merge requests - repository
Access StringLevel - Set the repository access level. Valid values are
disabled
,private
,enabled
. - repository
Storage String - Which storage shard the repository is on. (administrator only)
- request
Access BooleanEnabled - Allow users to request member access.
- requirements
Access StringLevel - Set the requirements access level. Valid values are
disabled
,private
,enabled
. - resolve
Outdated BooleanDiff Discussions - Automatically resolve merge request diffs discussions on lines changed with a push.
- restrict
User BooleanDefined Variables - Allow only users with the Maintainer role to pass user-defined variables when triggering a pipeline.
- runners
Token String - Registration token to use during runner setup.
- security
And StringCompliance Access Level - Set the security and compliance access level. Valid values are
disabled
,private
,enabled
. - List<Property Map>
- Describes groups which have access shared to this project.
- snippets
Access StringLevel - Set the snippets access level. Valid values are
disabled
,private
,enabled
. - snippets
Enabled Boolean - Enable snippets for the project.
- squash
Commit StringTemplate - Template used to create squash commit message in merge requests. (Introduced in GitLab 14.6.)
- ssh
Url StringTo Repo - URL that can be provided to
git clone
to clone the - suggestion
Commit StringMessage - The commit message used to apply merge request suggestions.
- topics List<String>
- The list of topics for the project.
- visibility
Level String - Repositories are created as private by default.
- web
Url String - URL that can be used to find the project in a browser.
- wiki
Access StringLevel - Set the wiki access level. Valid values are
disabled
,private
,enabled
. - wiki
Enabled Boolean - Enable wiki for the project.
- public
Builds Boolean - If true, jobs can be viewed by non-project members.
Supporting Types
GetProjectContainerExpirationPolicy
- Cadence string
- The cadence of the policy. Valid values are:
1d
,7d
,14d
,1month
,3month
. - Enabled bool
- If true, the policy is enabled.
- Keep
N int - The number of images to keep.
- Name
Regex string - The regular expression to match image names to delete.
- Name
Regex stringDelete - The regular expression to match image names to delete.
- Name
Regex stringKeep - The regular expression to match image names to keep.
- Next
Run stringAt - The next time the policy will run.
- Older
Than string - The number of days to keep images.
- Cadence string
- The cadence of the policy. Valid values are:
1d
,7d
,14d
,1month
,3month
. - Enabled bool
- If true, the policy is enabled.
- Keep
N int - The number of images to keep.
- Name
Regex string - The regular expression to match image names to delete.
- Name
Regex stringDelete - The regular expression to match image names to delete.
- Name
Regex stringKeep - The regular expression to match image names to keep.
- Next
Run stringAt - The next time the policy will run.
- Older
Than string - The number of days to keep images.
- cadence String
- The cadence of the policy. Valid values are:
1d
,7d
,14d
,1month
,3month
. - enabled Boolean
- If true, the policy is enabled.
- keep
N Integer - The number of images to keep.
- name
Regex String - The regular expression to match image names to delete.
- name
Regex StringDelete - The regular expression to match image names to delete.
- name
Regex StringKeep - The regular expression to match image names to keep.
- next
Run StringAt - The next time the policy will run.
- older
Than String - The number of days to keep images.
- cadence string
- The cadence of the policy. Valid values are:
1d
,7d
,14d
,1month
,3month
. - enabled boolean
- If true, the policy is enabled.
- keep
N number - The number of images to keep.
- name
Regex string - The regular expression to match image names to delete.
- name
Regex stringDelete - The regular expression to match image names to delete.
- name
Regex stringKeep - The regular expression to match image names to keep.
- next
Run stringAt - The next time the policy will run.
- older
Than string - The number of days to keep images.
- cadence str
- The cadence of the policy. Valid values are:
1d
,7d
,14d
,1month
,3month
. - enabled bool
- If true, the policy is enabled.
- keep_
n int - The number of images to keep.
- name_
regex str - The regular expression to match image names to delete.
- name_
regex_ strdelete - The regular expression to match image names to delete.
- name_
regex_ strkeep - The regular expression to match image names to keep.
- next_
run_ strat - The next time the policy will run.
- older_
than str - The number of days to keep images.
- cadence String
- The cadence of the policy. Valid values are:
1d
,7d
,14d
,1month
,3month
. - enabled Boolean
- If true, the policy is enabled.
- keep
N Number - The number of images to keep.
- name
Regex String - The regular expression to match image names to delete.
- name
Regex StringDelete - The regular expression to match image names to delete.
- name
Regex StringKeep - The regular expression to match image names to keep.
- next
Run StringAt - The next time the policy will run.
- older
Than String - The number of days to keep images.
GetProjectPushRule
- string
- All commit author emails must match this regex, e.g.
@my-company.com$
. - Branch
Name stringRegex - All branch names must match this regex, e.g.
(feature|hotfix)\/*
. - Commit
Committer boolCheck - Users can only push commits to this repository that were committed with one of their own verified emails.
- Commit
Committer boolName Check - Users can only push commits to this repository if the commit author name is consistent with their GitLab account name.
- Commit
Message stringNegative Regex - No commit message is allowed to match this regex, for example
ssh\:\/\/
. - Commit
Message stringRegex - All commit messages must match this regex, e.g.
Fixed \d+\..*
. - Deny
Delete boolTag - Deny deleting a tag.
- File
Name stringRegex - All committed filenames must not match this regex, e.g.
(jar|exe)$
. - Max
File intSize - Maximum file size (MB).
- Member
Check bool - Restrict commits by author (email) to existing GitLab users.
- Prevent
Secrets bool - GitLab will reject any files that are likely to contain secrets.
- Reject
Non boolDco Commits - Reject commit when it’s not DCO certified.
- Reject
Unsigned boolCommits - Reject commit when it’s not signed through GPG.
- string
- All commit author emails must match this regex, e.g.
@my-company.com$
. - Branch
Name stringRegex - All branch names must match this regex, e.g.
(feature|hotfix)\/*
. - Commit
Committer boolCheck - Users can only push commits to this repository that were committed with one of their own verified emails.
- Commit
Committer boolName Check - Users can only push commits to this repository if the commit author name is consistent with their GitLab account name.
- Commit
Message stringNegative Regex - No commit message is allowed to match this regex, for example
ssh\:\/\/
. - Commit
Message stringRegex - All commit messages must match this regex, e.g.
Fixed \d+\..*
. - Deny
Delete boolTag - Deny deleting a tag.
- File
Name stringRegex - All committed filenames must not match this regex, e.g.
(jar|exe)$
. - Max
File intSize - Maximum file size (MB).
- Member
Check bool - Restrict commits by author (email) to existing GitLab users.
- Prevent
Secrets bool - GitLab will reject any files that are likely to contain secrets.
- Reject
Non boolDco Commits - Reject commit when it’s not DCO certified.
- Reject
Unsigned boolCommits - Reject commit when it’s not signed through GPG.
- String
- All commit author emails must match this regex, e.g.
@my-company.com$
. - branch
Name StringRegex - All branch names must match this regex, e.g.
(feature|hotfix)\/*
. - commit
Committer BooleanCheck - Users can only push commits to this repository that were committed with one of their own verified emails.
- commit
Committer BooleanName Check - Users can only push commits to this repository if the commit author name is consistent with their GitLab account name.
- commit
Message StringNegative Regex - No commit message is allowed to match this regex, for example
ssh\:\/\/
. - commit
Message StringRegex - All commit messages must match this regex, e.g.
Fixed \d+\..*
. - deny
Delete BooleanTag - Deny deleting a tag.
- file
Name StringRegex - All committed filenames must not match this regex, e.g.
(jar|exe)$
. - max
File IntegerSize - Maximum file size (MB).
- member
Check Boolean - Restrict commits by author (email) to existing GitLab users.
- prevent
Secrets Boolean - GitLab will reject any files that are likely to contain secrets.
- reject
Non BooleanDco Commits - Reject commit when it’s not DCO certified.
- reject
Unsigned BooleanCommits - Reject commit when it’s not signed through GPG.
- string
- All commit author emails must match this regex, e.g.
@my-company.com$
. - branch
Name stringRegex - All branch names must match this regex, e.g.
(feature|hotfix)\/*
. - commit
Committer booleanCheck - Users can only push commits to this repository that were committed with one of their own verified emails.
- commit
Committer booleanName Check - Users can only push commits to this repository if the commit author name is consistent with their GitLab account name.
- commit
Message stringNegative Regex - No commit message is allowed to match this regex, for example
ssh\:\/\/
. - commit
Message stringRegex - All commit messages must match this regex, e.g.
Fixed \d+\..*
. - deny
Delete booleanTag - Deny deleting a tag.
- file
Name stringRegex - All committed filenames must not match this regex, e.g.
(jar|exe)$
. - max
File numberSize - Maximum file size (MB).
- member
Check boolean - Restrict commits by author (email) to existing GitLab users.
- prevent
Secrets boolean - GitLab will reject any files that are likely to contain secrets.
- reject
Non booleanDco Commits - Reject commit when it’s not DCO certified.
- reject
Unsigned booleanCommits - Reject commit when it’s not signed through GPG.
- str
- All commit author emails must match this regex, e.g.
@my-company.com$
. - branch_
name_ strregex - All branch names must match this regex, e.g.
(feature|hotfix)\/*
. - commit_
committer_ boolcheck - Users can only push commits to this repository that were committed with one of their own verified emails.
- commit_
committer_ boolname_ check - Users can only push commits to this repository if the commit author name is consistent with their GitLab account name.
- commit_
message_ strnegative_ regex - No commit message is allowed to match this regex, for example
ssh\:\/\/
. - commit_
message_ strregex - All commit messages must match this regex, e.g.
Fixed \d+\..*
. - deny_
delete_ booltag - Deny deleting a tag.
- file_
name_ strregex - All committed filenames must not match this regex, e.g.
(jar|exe)$
. - max_
file_ intsize - Maximum file size (MB).
- member_
check bool - Restrict commits by author (email) to existing GitLab users.
- prevent_
secrets bool - GitLab will reject any files that are likely to contain secrets.
- reject_
non_ booldco_ commits - Reject commit when it’s not DCO certified.
- reject_
unsigned_ boolcommits - Reject commit when it’s not signed through GPG.
- String
- All commit author emails must match this regex, e.g.
@my-company.com$
. - branch
Name StringRegex - All branch names must match this regex, e.g.
(feature|hotfix)\/*
. - commit
Committer BooleanCheck - Users can only push commits to this repository that were committed with one of their own verified emails.
- commit
Committer BooleanName Check - Users can only push commits to this repository if the commit author name is consistent with their GitLab account name.
- commit
Message StringNegative Regex - No commit message is allowed to match this regex, for example
ssh\:\/\/
. - commit
Message StringRegex - All commit messages must match this regex, e.g.
Fixed \d+\..*
. - deny
Delete BooleanTag - Deny deleting a tag.
- file
Name StringRegex - All committed filenames must not match this regex, e.g.
(jar|exe)$
. - max
File NumberSize - Maximum file size (MB).
- member
Check Boolean - Restrict commits by author (email) to existing GitLab users.
- prevent
Secrets Boolean - GitLab will reject any files that are likely to contain secrets.
- reject
Non BooleanDco Commits - Reject commit when it’s not DCO certified.
- reject
Unsigned BooleanCommits - Reject commit when it’s not signed through GPG.
GetProjectSharedWithGroup
- Group
Access intLevel - The access_level permission level of the shared group.
- Group
Full stringPath - The full path of the group shared with.
- Group
Id int - The ID of the group shared with.
- Group
Name string - The name of the group shared with.
- Group
Access intLevel - The access_level permission level of the shared group.
- Group
Full stringPath - The full path of the group shared with.
- Group
Id int - The ID of the group shared with.
- Group
Name string - The name of the group shared with.
- group
Access IntegerLevel - The access_level permission level of the shared group.
- group
Full StringPath - The full path of the group shared with.
- group
Id Integer - The ID of the group shared with.
- group
Name String - The name of the group shared with.
- group
Access numberLevel - The access_level permission level of the shared group.
- group
Full stringPath - The full path of the group shared with.
- group
Id number - The ID of the group shared with.
- group
Name string - The name of the group shared with.
- group_
access_ intlevel - The access_level permission level of the shared group.
- group_
full_ strpath - The full path of the group shared with.
- group_
id int - The ID of the group shared with.
- group_
name str - The name of the group shared with.
- group
Access NumberLevel - The access_level permission level of the shared group.
- group
Full StringPath - The full path of the group shared with.
- group
Id Number - The ID of the group shared with.
- group
Name String - The name of the group shared with.
Package Details
- Repository
- GitLab pulumi/pulumi-gitlab
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
gitlab
Terraform Provider.