From b3bf7d7774c20644cb86dc7093f282454f460c2a Mon Sep 17 00:00:00 2001 From: rad-ci-bot Date: Thu, 5 Sep 2024 05:55:14 +0000 Subject: [PATCH] Autogenerate reference docs Signed-off-by: rad-ci-bot --- .../reference/cli/rad_install_kubernetes.md | 4 +- .../reference/cli/rad_uninstall_kubernetes.md | 1 + .../2023-10-01-preview/containers/index.md | 28 ++++++++++++- .../2023-10-01-preview/secretstores/index.md | 2 +- .../2023-10-01-preview/pubsubbrokers/index.md | 39 ++++++++++++++++++- .../2023-10-01-preview/secretstores/index.md | 30 +++++++++++++- .../2023-10-01-preview/statestores/index.md | 39 ++++++++++++++++++- 7 files changed, 136 insertions(+), 7 deletions(-) diff --git a/docs/content/reference/cli/rad_install_kubernetes.md b/docs/content/reference/cli/rad_install_kubernetes.md index 1df499317..472ee21cf 100644 --- a/docs/content/reference/cli/rad_install_kubernetes.md +++ b/docs/content/reference/cli/rad_install_kubernetes.md @@ -15,9 +15,9 @@ Installs Radius onto a kubernetes cluster Install Radius in a Kubernetes cluster using the Radius Helm chart. By default 'rad install kubernetes' will install Radius with the version matching the rad CLI version. -Radius will be installed in the 'radius-system' namespace. For more information visit https://docs.radapp.io/concepts/architecture/ +Radius will be installed in the 'radius-system' namespace. For more information visit https://docs.radapp.io/concepts/technical/architecture/ -Overrides can be set by specifying Helm chart values with the '--set' flag. For more information visit https://docs.radapp.io/operations/platforms/kubernetes/install/. +Overrides can be set by specifying Helm chart values with the '--set' flag. For more information visit https://docs.radapp.io/guides/operations/kubernetes/install/. ``` diff --git a/docs/content/reference/cli/rad_uninstall_kubernetes.md b/docs/content/reference/cli/rad_uninstall_kubernetes.md index 84ee002d1..1e58e00d1 100644 --- a/docs/content/reference/cli/rad_uninstall_kubernetes.md +++ b/docs/content/reference/cli/rad_uninstall_kubernetes.md @@ -33,6 +33,7 @@ rad uninstall kubernetes --kubecontext my-kubecontext ``` -h, --help help for kubernetes --kubecontext string The Kubernetes context to use, will use the default if unset + --purge Delete all data stored by Radius. ``` ### Options inherited from parent commands diff --git a/docs/content/reference/resources/applications/applications.core/2023-10-01-preview/containers/index.md b/docs/content/reference/resources/applications/applications.core/2023-10-01-preview/containers/index.md index 763f4befa..ba34d6d01 100644 --- a/docs/content/reference/resources/applications/applications.core/2023-10-01-preview/containers/index.md +++ b/docs/content/reference/resources/applications/applications.core/2023-10-01-preview/containers/index.md @@ -97,7 +97,33 @@ description: "Detailed reference documentation for applications.core/containers@ #### Additional Properties -* **Additional Properties Type**: string +* **Additional Properties Type**: [EnvironmentVariable](#environmentvariable) + +### EnvironmentVariable + +#### Properties + +| Property | Type | Description | +|----------|------|-------------| +| **value** | string | The value of the environment variable | +| **valueFrom** | [EnvironmentVariableReference](#environmentvariablereference) | The reference to the variable | + +### EnvironmentVariableReference + +#### Properties + +| Property | Type | Description | +|----------|------|-------------| +| **secretRef** | [SecretReference](#secretreference) | This secret is used within a recipe. Secrets are encrypted, often have fine-grained access control, auditing and are recommended to be used to hold sensitive data.
_(Required)_ | + +### SecretReference + +#### Properties + +| Property | Type | Description | +|----------|------|-------------| +| **key** | string | The key for the secret in the secret store.
_(Required)_ | +| **source** | string | The ID of an Applications.Core/SecretStore resource containing sensitive data required for recipe execution.
_(Required)_ | ### HealthProbeProperties diff --git a/docs/content/reference/resources/applications/applications.core/2023-10-01-preview/secretstores/index.md b/docs/content/reference/resources/applications/applications.core/2023-10-01-preview/secretstores/index.md index dfa045b42..1883ac9fe 100644 --- a/docs/content/reference/resources/applications/applications.core/2023-10-01-preview/secretstores/index.md +++ b/docs/content/reference/resources/applications/applications.core/2023-10-01-preview/secretstores/index.md @@ -36,7 +36,7 @@ description: "Detailed reference documentation for applications.core/secretstore | **provisioningState** | 'Accepted' | 'Canceled' | 'Deleting' | 'Failed' | 'Provisioning' | 'Succeeded' | 'Updating' | Provisioning state of the resource at the time the operation was called
_(ReadOnly)_ | | **resource** | string | The resource id of external secret store. | | **status** | [ResourceStatus](#resourcestatus) | Status of a resource.
_(ReadOnly)_ | -| **type** | 'certificate' | 'generic' | The type of SecretStore data | +| **type** | 'awsIRSA' | 'azureWorkloadIdentity' | 'basicAuthentication' | 'certificate' | 'generic' | The type of SecretStore data | ### SecretStorePropertiesData diff --git a/docs/content/reference/resources/applications/applications.dapr/2023-10-01-preview/pubsubbrokers/index.md b/docs/content/reference/resources/applications/applications.dapr/2023-10-01-preview/pubsubbrokers/index.md index a9838e939..3c2a88b40 100644 --- a/docs/content/reference/resources/applications/applications.dapr/2023-10-01-preview/pubsubbrokers/index.md +++ b/docs/content/reference/resources/applications/applications.dapr/2023-10-01-preview/pubsubbrokers/index.md @@ -31,9 +31,10 @@ description: "Detailed reference documentation for applications.dapr/pubsubbroke | Property | Type | Description | |----------|------|-------------| | **application** | string | Fully qualified resource ID for the application that the portable resource is consumed by (if applicable) | +| **auth** | [DaprResourceAuth](#daprresourceauth) | Authentication properties for a Dapr component object | | **componentName** | string | The name of the Dapr component object. Use this value in your code when interacting with the Dapr client to use the Dapr component.
_(ReadOnly)_ | | **environment** | string | Fully qualified resource ID for the environment that the portable resource is linked to
_(Required)_ | -| **metadata** | any | Any object | +| **metadata** | [DaprPubSubBrokerPropertiesMetadata](#daprpubsubbrokerpropertiesmetadata) | The metadata for Dapr resource which must match the values specified in Dapr component spec | | **provisioningState** | 'Accepted' | 'Canceled' | 'Deleting' | 'Failed' | 'Provisioning' | 'Succeeded' | 'Updating' | Provisioning state of the resource at the time the operation was called
_(ReadOnly)_ | | **recipe** | [Recipe](#recipe) | The recipe used to automatically deploy underlying infrastructure for a portable resource | | **resourceProvisioning** | 'manual' | 'recipe' | Specifies how the underlying service/resource is provisioned and managed. Available values are 'recipe', where Radius manages the lifecycle of the resource through a Recipe, and 'manual', where a user manages the resource and provides the values. | @@ -42,6 +43,42 @@ description: "Detailed reference documentation for applications.dapr/pubsubbroke | **type** | string | Dapr component type which must matches the format used by Dapr Kubernetes configuration format | | **version** | string | Dapr component version | +### DaprResourceAuth + +#### Properties + +| Property | Type | Description | +|----------|------|-------------| +| **secretStore** | string | Secret store to fetch secrets from | + +### DaprPubSubBrokerPropertiesMetadata + +#### Properties + +* **none** + +#### Additional Properties + +* **Additional Properties Type**: [MetadataValue](#metadatavalue) + +### MetadataValue + +#### Properties + +| Property | Type | Description | +|----------|------|-------------| +| **secretKeyRef** | [MetadataValueFromSecret](#metadatavaluefromsecret) | A reference of a value in a secret store component. | +| **value** | string | The plain text value of the metadata | + +### MetadataValueFromSecret + +#### Properties + +| Property | Type | Description | +|----------|------|-------------| +| **key** | string | The field to select in the secret value. If the secret value is a string, it should be equal to the secret name
_(Required)_ | +| **name** | string | Secret name in the secret store component
_(Required)_ | + ### Recipe #### Properties diff --git a/docs/content/reference/resources/applications/applications.dapr/2023-10-01-preview/secretstores/index.md b/docs/content/reference/resources/applications/applications.dapr/2023-10-01-preview/secretstores/index.md index 0f47923b2..4c21726d9 100644 --- a/docs/content/reference/resources/applications/applications.dapr/2023-10-01-preview/secretstores/index.md +++ b/docs/content/reference/resources/applications/applications.dapr/2023-10-01-preview/secretstores/index.md @@ -33,7 +33,7 @@ description: "Detailed reference documentation for applications.dapr/secretstore | **application** | string | Fully qualified resource ID for the application that the portable resource is consumed by (if applicable) | | **componentName** | string | The name of the Dapr component object. Use this value in your code when interacting with the Dapr client to use the Dapr component.
_(ReadOnly)_ | | **environment** | string | Fully qualified resource ID for the environment that the portable resource is linked to
_(Required)_ | -| **metadata** | any | Any object | +| **metadata** | [DaprSecretStorePropertiesMetadata](#daprsecretstorepropertiesmetadata) | The metadata for Dapr resource which must match the values specified in Dapr component spec | | **provisioningState** | 'Accepted' | 'Canceled' | 'Deleting' | 'Failed' | 'Provisioning' | 'Succeeded' | 'Updating' | Provisioning state of the resource at the time the operation was called
_(ReadOnly)_ | | **recipe** | [Recipe](#recipe) | The recipe used to automatically deploy underlying infrastructure for a portable resource | | **resourceProvisioning** | 'manual' | 'recipe' | Specifies how the underlying service/resource is provisioned and managed. Available values are 'recipe', where Radius manages the lifecycle of the resource through a Recipe, and 'manual', where a user manages the resource and provides the values. | @@ -41,6 +41,34 @@ description: "Detailed reference documentation for applications.dapr/secretstore | **type** | string | Dapr component type which must matches the format used by Dapr Kubernetes configuration format | | **version** | string | Dapr component version | +### DaprSecretStorePropertiesMetadata + +#### Properties + +* **none** + +#### Additional Properties + +* **Additional Properties Type**: [MetadataValue](#metadatavalue) + +### MetadataValue + +#### Properties + +| Property | Type | Description | +|----------|------|-------------| +| **secretKeyRef** | [MetadataValueFromSecret](#metadatavaluefromsecret) | A reference of a value in a secret store component. | +| **value** | string | The plain text value of the metadata | + +### MetadataValueFromSecret + +#### Properties + +| Property | Type | Description | +|----------|------|-------------| +| **key** | string | The field to select in the secret value. If the secret value is a string, it should be equal to the secret name
_(Required)_ | +| **name** | string | Secret name in the secret store component
_(Required)_ | + ### Recipe #### Properties diff --git a/docs/content/reference/resources/applications/applications.dapr/2023-10-01-preview/statestores/index.md b/docs/content/reference/resources/applications/applications.dapr/2023-10-01-preview/statestores/index.md index cab18c1b2..94c5621c8 100644 --- a/docs/content/reference/resources/applications/applications.dapr/2023-10-01-preview/statestores/index.md +++ b/docs/content/reference/resources/applications/applications.dapr/2023-10-01-preview/statestores/index.md @@ -31,9 +31,10 @@ description: "Detailed reference documentation for applications.dapr/statestores | Property | Type | Description | |----------|------|-------------| | **application** | string | Fully qualified resource ID for the application that the portable resource is consumed by (if applicable) | +| **auth** | [DaprResourceAuth](#daprresourceauth) | Authentication properties for a Dapr component object | | **componentName** | string | The name of the Dapr component object. Use this value in your code when interacting with the Dapr client to use the Dapr component.
_(ReadOnly)_ | | **environment** | string | Fully qualified resource ID for the environment that the portable resource is linked to
_(Required)_ | -| **metadata** | any | Any object | +| **metadata** | [DaprStateStorePropertiesMetadata](#daprstatestorepropertiesmetadata) | The metadata for Dapr resource which must match the values specified in Dapr component spec | | **provisioningState** | 'Accepted' | 'Canceled' | 'Deleting' | 'Failed' | 'Provisioning' | 'Succeeded' | 'Updating' | Provisioning state of the resource at the time the operation was called
_(ReadOnly)_ | | **recipe** | [Recipe](#recipe) | The recipe used to automatically deploy underlying infrastructure for a portable resource | | **resourceProvisioning** | 'manual' | 'recipe' | Specifies how the underlying service/resource is provisioned and managed. Available values are 'recipe', where Radius manages the lifecycle of the resource through a Recipe, and 'manual', where a user manages the resource and provides the values. | @@ -42,6 +43,42 @@ description: "Detailed reference documentation for applications.dapr/statestores | **type** | string | Dapr component type which must matches the format used by Dapr Kubernetes configuration format | | **version** | string | Dapr component version | +### DaprResourceAuth + +#### Properties + +| Property | Type | Description | +|----------|------|-------------| +| **secretStore** | string | Secret store to fetch secrets from | + +### DaprStateStorePropertiesMetadata + +#### Properties + +* **none** + +#### Additional Properties + +* **Additional Properties Type**: [MetadataValue](#metadatavalue) + +### MetadataValue + +#### Properties + +| Property | Type | Description | +|----------|------|-------------| +| **secretKeyRef** | [MetadataValueFromSecret](#metadatavaluefromsecret) | A reference of a value in a secret store component. | +| **value** | string | The plain text value of the metadata | + +### MetadataValueFromSecret + +#### Properties + +| Property | Type | Description | +|----------|------|-------------| +| **key** | string | The field to select in the secret value. If the secret value is a string, it should be equal to the secret name
_(Required)_ | +| **name** | string | Secret name in the secret store component
_(Required)_ | + ### Recipe #### Properties