yandex_gitlab_instance (Resource)
Written by
Updated at August 7, 2025
Managed Gitlab instance.
Example usage
//
// Create a new GitLab instance.
//
resource "yandex_gitlab_instance" "my_gitlab_instance" {
name = "gitlab-created-with-terraform"
resource_preset_id = "s2.micro"
disk_size = 30
admin_login = "gitlab-user"
admin_email = "gitlab-user@example.com"
domain = "gitlab-terraform.gitlab.yandexcloud.net"
subnet_id = yandex_vpc_subnet.a.id
backup_retain_period_days = 7
}
Schema
Required
admin_email(String) An email of admin user in Gitlab.admin_login(String) A login of admin user in Gitlab.approval_rules_id(String) Approval rules configuration. One of: NONE, BASIC, STANDARD, ADVANCED.backup_retain_period_days(Number) Auto backups retain period in days.disk_size(Number) Amount of disk storage available to a instance in GB.domain(String) Domain of the Gitlab instance.name(String) The resource name.resource_preset_id(String) ID of the preset for computational resources available to the instance (CPU, memory etc.). One of: s2.micro, s2.small, s2.medium, s2.large.subnet_id(String) ID of the subnet where the GitLab instance is located.
Optional
approval_rules_token(String, Sensitive) Approval rules token.deletion_protection(Boolean) Thetruevalue means that resource is protected from accidental deletion.description(String) The resource description.folder_id(String) The folder identifier that resource belongs to. If it is not provided, the default providerfolder-idis used.labels(Map of String) A set of key/value label pairs which assigned to resource.maintenance_delete_untagged(Boolean) Thetruevalue means that untagged images will be deleted during maintenance.timeouts(Block, Optional) (see below for nested schema)
Read-Only
created_at(String) The creation timestamp of the resource.gitlab_version(String) Version of Gitlab on instance.id(String) The resource identifier.status(String) Status of the instance.updated_at(String) The timestamp when the instance was updated.
Nested Schema for timeouts
Optional:
create(String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).delete(String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.update(String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
Import
The resource can be imported by using their resource ID. For getting the resource ID you can use Yandex Cloud Web Console
# terraform import yandex_gitlab_instance.<resource Name> <resource Id>
terraform import yandex_gitlab_instance.my_gitlab_instance c172a**********ubpme