chore(docs): update docs (#725)
* chore(deps): bump terraform-plugin-docs from v0.16.0 to v0.21.0 * chore(docs): fix docs after generation using a patchfile * chore(docs): re-generate docs
This commit is contained in:
Ruben Hönle
GitHub
parent
6cc1dffc22
commit
698bbca3cc
14 changed files with 116 additions and 77 deletions
|
|
@ -36,5 +36,3 @@ data "stackit_objectstorage_bucket" "example" {
|
|||
- `id` (String) Terraform's internal data source identifier. It is structured as "`project_id`,`name`".
|
||||
- `url_path_style` (String)
|
||||
- `url_virtual_hosted_style` (String)
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -40,5 +40,3 @@ data "stackit_objectstorage_credentials_group" "example" {
|
|||
- `id` (String) Terraform's internal resource identifier. It is structured as "`project_id`,`credentials_group_id`,`credential_id`".
|
||||
- `name` (String)
|
||||
- `secret_access_key` (String, Sensitive)
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -36,5 +36,3 @@ data "stackit_objectstorage_credentials_group" "example" {
|
|||
|
||||
- `id` (String) Terraform's internal data source identifier. It is structured as "`project_id`,`credentials_group_id`".
|
||||
- `urn` (String) Credentials group uniform resource name (URN)
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -33,4 +33,4 @@ data "stackit_resourcemanager_project" "example" {
|
|||
- `id` (String) Terraform's internal data source. ID. It is structured as "`container_id`".
|
||||
- `labels` (Map of String) Labels are key-value string pairs which can be attached to a resource container. A label key must match the regex [A-ZÄÜÖa-zäüöß0-9_-]{1,64}. A label value must match the regex ^$|[A-ZÄÜÖa-zäüöß0-9_-]{1,64}
|
||||
- `name` (String) Project name.
|
||||
- `parent_container_id` (String) Parent resource identifier. Both container ID (user-friendly) and UUID are supported
|
||||
- `parent_container_id` (String) Parent resource identifier. Both container ID (user-friendly) and UUID are supported
|
||||
|
|
|
|||
|
|
@ -5,29 +5,35 @@ subcategory: ""
|
|||
description: |-
|
||||
Affinity Group schema. Must have a region specified in the provider configuration.
|
||||
Usage with server
|
||||
```terraform
|
||||
resource "stackitaffinitygroup" "affinity-group" {
|
||||
|
||||
resource "stackit_affinity_group" "affinity-group" {
|
||||
project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
name = "example-key-pair"
|
||||
policy = "soft-affinity"
|
||||
}
|
||||
resource "stackitserver" "example-server" {
|
||||
projectid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
|
||||
resource "stackit_server" "example-server" {
|
||||
project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
name = "example-server"
|
||||
bootvolume = {
|
||||
boot_volume = {
|
||||
size = 64
|
||||
sourcetype = "image"
|
||||
sourceid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
source_type = "image"
|
||||
source_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
}
|
||||
affinitygroup = stackitaffinitygroup.affinity-group.affinitygroupid
|
||||
availabilityzone = "eu01-1"
|
||||
machinetype = "g1.1"
|
||||
affinity_group = stackit_affinity_group.affinity-group.affinity_group_id
|
||||
availability_zone = "eu01-1"
|
||||
machine_type = "g1.1"
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
Policies
|
||||
hard-affinity- All servers launched in this group will be hosted on the same compute node.hard-anti-affinity- All servers launched in this group will be
|
||||
hosted on different compute nodes.soft-affinity- All servers launched in this group will be hosted
|
||||
on the same compute node if possible, but if not possible they still will be scheduled instead of failure.soft-anti-affinity- All servers launched in this group will be hosted on different compute nodes if possible,
|
||||
|
||||
hard-affinity- All servers launched in this group will be hosted on the same compute node.
|
||||
hard-anti-affinity- All servers launched in this group will be
|
||||
hosted on different compute nodes.
|
||||
soft-affinity- All servers launched in this group will be hosted
|
||||
on the same compute node if possible, but if not possible they still will be scheduled instead of failure.
|
||||
soft-anti-affinity- All servers launched in this group will be hosted on different compute nodes if possible,
|
||||
but if not possible they still will be scheduled instead of failure.
|
||||
~> This resource is in beta and may be subject to breaking changes in the future. Use with caution. See our guide https://registry.terraform.io/providers/stackitcloud/stackit/latest/docs/guides/opting_into_beta_resources for how to opt-in to use beta resources.
|
||||
---
|
||||
|
|
|
|||
|
|
@ -7,23 +7,22 @@ description: |-
|
|||
!> The stackit_argus_credential resource has been deprecated and will be removed after February 26th 2025. Please use stackit_observability_credential instead, which offers the exact same functionality.
|
||||
Example move
|
||||
Example to move the deprecated stackit_argus_credential resource to the new stackit_observability_credential resource:
|
||||
1. Add a new stackit_observability_credential resource with the same values like your previous stackit_argus_credential resource.
|
||||
1. Add a moved block which reference the stackit_argus_credential and stackit_observability_credential resource.
|
||||
1. Remove your old stackit_argus_credential resource and run $ terraform apply.
|
||||
```terraform
|
||||
resource "stackitarguscredential" "example" {
|
||||
projectid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
instanceid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
Add a new stackit_observability_credential resource with the same values like your previous stackit_argus_credential resource.Add a moved block which reference the stackit_argus_credential and stackit_observability_credential resource.Remove your old stackit_argus_credential resource and run $ terraform apply.
|
||||
|
||||
resource "stackit_argus_credential" "example" {
|
||||
project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
instance_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
}
|
||||
|
||||
moved {
|
||||
from = stackitarguscredential.example
|
||||
to = stackitobservabilitycredential.example
|
||||
from = stackit_argus_credential.example
|
||||
to = stackit_observability_credential.example
|
||||
}
|
||||
resource "stackitobservabilitycredential" "example" {
|
||||
projectid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
instanceid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
|
||||
resource "stackit_observability_credential" "example" {
|
||||
project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
instance_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
}
|
||||
```
|
||||
---
|
||||
|
||||
# stackit_argus_credential (Resource)
|
||||
|
|
|
|||
|
|
@ -7,33 +7,32 @@ description: |-
|
|||
!> The stackit_argus_instance resource has been deprecated and will be removed after February 26th 2025. Please use stackit_observability_instance instead, which offers the exact same functionality.
|
||||
Example move
|
||||
Example to move the deprecated stackit_argus_instance resource to the newstackit_observability_instance resource:
|
||||
1. Add a new stackit_observability_instance resource with the same values like your previous stackit_argus_instance resource.
|
||||
1. Add a moved block which reference the stackit_argus_instance and stackit_observability_instance resource.
|
||||
1. Remove your old stackit_argus_instance resource and run $ terraform apply.
|
||||
```terraform
|
||||
resource "stackitargusinstance" "example" {
|
||||
projectid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
Add a new stackit_observability_instance resource with the same values like your previous stackit_argus_instance resource.Add a moved block which reference the stackit_argus_instance and stackit_observability_instance resource.Remove your old stackit_argus_instance resource and run $ terraform apply.
|
||||
|
||||
resource "stackit_argus_instance" "example" {
|
||||
project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
name = "example-instance"
|
||||
planname = "Monitoring-Medium-EU01"
|
||||
plan_name = "Monitoring-Medium-EU01"
|
||||
acl = ["1.1.1.1/32", "2.2.2.2/32"]
|
||||
metricsretentiondays = 7
|
||||
metricsretentiondays5mdownsampling = 30
|
||||
metricsretentiondays1hdownsampling = 365
|
||||
metrics_retention_days = 7
|
||||
metrics_retention_days_5m_downsampling = 30
|
||||
metrics_retention_days_1h_downsampling = 365
|
||||
}
|
||||
|
||||
moved {
|
||||
from = stackitargusinstance.example
|
||||
to = stackitobservabilityinstance.example
|
||||
from = stackit_argus_instance.example
|
||||
to = stackit_observability_instance.example
|
||||
}
|
||||
resource "stackitobservabilityinstance" "example" {
|
||||
projectid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
|
||||
resource "stackit_observability_instance" "example" {
|
||||
project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
name = "example-instance"
|
||||
planname = "Monitoring-Medium-EU01"
|
||||
plan_name = "Monitoring-Medium-EU01"
|
||||
acl = ["1.1.1.1/32", "2.2.2.2/32"]
|
||||
metricsretentiondays = 7
|
||||
metricsretentiondays5mdownsampling = 30
|
||||
metricsretentiondays1hdownsampling = 365
|
||||
metrics_retention_days = 7
|
||||
metrics_retention_days_5m_downsampling = 30
|
||||
metrics_retention_days_1h_downsampling = 365
|
||||
}
|
||||
```
|
||||
---
|
||||
|
||||
# stackit_argus_instance (Resource)
|
||||
|
|
|
|||
|
|
@ -7,17 +7,15 @@ description: |-
|
|||
!> The stackit_argus_scrapeconfig resource has been deprecated and will be removed after February 26th 2025. Please use stackit_observability_scrapeconfig instead, which offers the exact same functionality.
|
||||
Example move
|
||||
Example to move the deprecated stackit_argus_scrapeconfig resource to the new stackit_observability_scrapeconfig resource:
|
||||
1. Add a new stackit_observability_scrapeconfig resource with the same values like your previous stackit_argus_scrapeconfig resource.
|
||||
1. Add a moved block which reference the stackit_argus_scrapeconfig and stackit_observability_scrapeconfig resource.
|
||||
1. Remove your old stackit_argus_scrapeconfig resource and run $ terraform apply.
|
||||
```terraform
|
||||
resource "stackitargusscrapeconfig" "example" {
|
||||
projectid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
instanceid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
Add a new stackit_observability_scrapeconfig resource with the same values like your previous stackit_argus_scrapeconfig resource.Add a moved block which reference the stackit_argus_scrapeconfig and stackit_observability_scrapeconfig resource.Remove your old stackit_argus_scrapeconfig resource and run $ terraform apply.
|
||||
|
||||
resource "stackit_argus_scrapeconfig" "example" {
|
||||
project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
instance_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
name = "example-job"
|
||||
metricspath = "/my-metrics"
|
||||
metrics_path = "/my-metrics"
|
||||
saml2 = {
|
||||
enableurl_parameters = true
|
||||
enable_url_parameters = true
|
||||
}
|
||||
targets = [
|
||||
{
|
||||
|
|
@ -28,17 +26,19 @@ description: |-
|
|||
}
|
||||
]
|
||||
}
|
||||
|
||||
moved {
|
||||
from = stackitargusscrapeconfig.example
|
||||
to = stackitobservabilityscrapeconfig.example
|
||||
from = stackit_argus_scrapeconfig.example
|
||||
to = stackit_observability_scrapeconfig.example
|
||||
}
|
||||
resource "stackitobservabilityscrapeconfig" "example" {
|
||||
projectid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
instanceid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
|
||||
resource "stackit_observability_scrapeconfig" "example" {
|
||||
project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
instance_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
||||
name = "example-job"
|
||||
metricspath = "/my-metrics"
|
||||
metrics_path = "/my-metrics"
|
||||
saml2 = {
|
||||
enableurl_parameters = true
|
||||
enable_url_parameters = true
|
||||
}
|
||||
targets = [
|
||||
{
|
||||
|
|
@ -49,7 +49,6 @@ description: |-
|
|||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
---
|
||||
|
||||
# stackit_argus_scrapeconfig (Resource)
|
||||
|
|
|
|||
|
|
@ -36,5 +36,3 @@ resource "stackit_objectstorage_bucket" "example" {
|
|||
- `id` (String) Terraform's internal resource identifier. It is structured as "`project_id`,`name`".
|
||||
- `url_path_style` (String)
|
||||
- `url_virtual_hosted_style` (String)
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -40,5 +40,3 @@ resource "stackit_objectstorage_credential" "example" {
|
|||
- `id` (String) Terraform's internal resource identifier. It is structured as "`project_id`,`credentials_group_id`,`credential_id`".
|
||||
- `name` (String)
|
||||
- `secret_access_key` (String, Sensitive)
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -36,5 +36,3 @@ resource "stackit_objectstorage_credentials_group" "example" {
|
|||
- `credentials_group_id` (String) The credentials group ID
|
||||
- `id` (String) Terraform's internal data source identifier. It is structured as "`project_id`,`credentials_group_id`".
|
||||
- `urn` (String) Credentials group uniform resource name (URN)
|
||||
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue