* Add test case * Fix tests * Add test dependencies correctly * Feed through error handling * Include test output * Get types to line up * Add remaining test files * Update changelog * Correctly find type paths * Handle transitive objects * Handle required fields * Add required+default test case * Don't `<any>` cast known types. * Add plain object to env-helper test This test fails right now. My next problem is fixing it. * Handle plain types * Handle function inputs * Fix the indentation * Handle output types correctly * Remove unnecessary `!` * Add missing change to fix test * Run tests with merge * Merge in next _index.md diff * Another attempt at _index.md * Make module generation deterministic * Fix docs generation Credit to @praneetloke
39 KiB
title: "Foo" title_tag: "example.Foo" meta_desc: "Documentation for the example.Foo resource with examples, input properties, output properties, lookup functions, and supporting types." layout: api no_edit_this_page: true
test new feature with resoruces
Create a Foo Resource
{{< chooser language "typescript,python,go,csharp" / >}}
{{% choosable language nodejs %}}
new Foo(name: string, args: FooArgs, opts?: CustomResourceOptions);
{{% choosable language python %}}
@overload
def Foo(resource_name: str,
opts: Optional[ResourceOptions] = None,
argument: Optional[str] = None,
backup_kube_client_settings: Optional[KubeClientSettingsArgs] = None,
kube_client_settings: Optional[KubeClientSettingsArgs] = None,
settings: Optional[LayeredTypeArgs] = None)
@overload
def Foo(resource_name: str,
args: FooArgs,
opts: Optional[ResourceOptions] = None)
{{% choosable language go %}}
func NewFoo(ctx *Context, name string, args FooArgs, opts ...ResourceOption) (*Foo, error)
{{% choosable language csharp %}}
public Foo(string name, FooArgs args, CustomResourceOptions? opts = null)
{{% choosable language nodejs %}}
- name string
- The unique name of the resource.
- args FooArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
{{% /choosable %}}
{{% choosable language python %}}
- resource_name str
- The unique name of the resource.
- args FooArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
{{% /choosable %}}
{{% choosable language go %}}
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args FooArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
{{% /choosable %}}
{{% choosable language csharp %}}
- name string
- The unique name of the resource.
- args FooArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
{{% /choosable %}}
Foo Resource Properties
To learn more about resource properties and how to use them, see [Inputs and Outputs]({{< relref "/docs/intro/concepts/inputs-outputs" >}}) in the Architecture and Concepts docs.
Inputs
The Foo resource accepts the following [input]({{< relref "/docs/intro/concepts/inputs-outputs" >}}) properties:
{{% choosable language csharp %}}
-
Backup
Kube KubeClient Settings Client Settings Args - {{% md %}}Options for tuning the Kubernetes client used by a Provider.{{% /md %}}
- Argument string
- {{% md %}}{{% /md %}}
-
Kube
Client KubeSettings Client Settings Args - {{% md %}}Options for tuning the Kubernetes client used by a Provider.{{% /md %}}
-
Settings
Layered
Type Args - {{% md %}}describing things{{% /md %}}
{{% choosable language go %}}
-
Backup
Kube KubeClient Settings Client Settings Args - {{% md %}}Options for tuning the Kubernetes client used by a Provider.{{% /md %}}
- Argument string
- {{% md %}}{{% /md %}}
-
Kube
Client KubeSettings Client Settings Args - {{% md %}}Options for tuning the Kubernetes client used by a Provider.{{% /md %}}
-
Settings
Layered
Type Args - {{% md %}}describing things{{% /md %}}
{{% choosable language nodejs %}}
-
backup
Kube KubeClient Settings Client Settings Args - {{% md %}}Options for tuning the Kubernetes client used by a Provider.{{% /md %}}
- argument string
- {{% md %}}{{% /md %}}
-
kube
Client KubeSettings Client Settings Args - {{% md %}}Options for tuning the Kubernetes client used by a Provider.{{% /md %}}
-
settings
Layered
Type Args - {{% md %}}describing things{{% /md %}}
{{% choosable language python %}}
-
backup_
kube_ Kubeclient_ settings Client Settings Args - {{% md %}}Options for tuning the Kubernetes client used by a Provider.{{% /md %}}
- argument str
- {{% md %}}{{% /md %}}
-
kube_
client_ Kubesettings Client Settings Args - {{% md %}}Options for tuning the Kubernetes client used by a Provider.{{% /md %}}
-
settings
Layered
Type Args - {{% md %}}describing things{{% /md %}}
Outputs
All input properties are implicitly available as output properties. Additionally, the Foo resource produces the following output properties:
{{% choosable language csharp %}}
- Id string
- {{% md %}}The provider-assigned unique ID for this managed resource.{{% /md %}}
-
Default
Kube KubeClient Settings Client Settings - {{% md %}}A test for plain types{{% /md %}}
{{% choosable language go %}}
- Id string
- {{% md %}}The provider-assigned unique ID for this managed resource.{{% /md %}}
-
Default
Kube KubeClient Settings Client Settings - {{% md %}}A test for plain types{{% /md %}}
{{% choosable language nodejs %}}
- id string
- {{% md %}}The provider-assigned unique ID for this managed resource.{{% /md %}}
-
default
Kube KubeClient Settings Client Settings - {{% md %}}A test for plain types{{% /md %}}
{{% choosable language python %}}
- id str
- {{% md %}}The provider-assigned unique ID for this managed resource.{{% /md %}}
-
default_
kube_ Kubeclient_ settings Client Settings - {{% md %}}A test for plain types{{% /md %}}
Supporting Types
HelmReleaseSettings
{{% choosable language csharp %}}
-
Required
Arg string - {{% md %}}to test required args{{% /md %}}
- Driver string
- {{% md %}}The backend storage driver for Helm. Values are: configmap, secret, memory, sql.{{% /md %}}
-
Plugins
Path string - {{% md %}}The path to the helm plugins directory.{{% /md %}}
{{% choosable language go %}}
-
Required
Arg string - {{% md %}}to test required args{{% /md %}}
- Driver string
- {{% md %}}The backend storage driver for Helm. Values are: configmap, secret, memory, sql.{{% /md %}}
-
Plugins
Path string - {{% md %}}The path to the helm plugins directory.{{% /md %}}
{{% choosable language nodejs %}}
-
required
Arg string - {{% md %}}to test required args{{% /md %}}
- driver string
- {{% md %}}The backend storage driver for Helm. Values are: configmap, secret, memory, sql.{{% /md %}}
-
plugins
Path string - {{% md %}}The path to the helm plugins directory.{{% /md %}}
{{% choosable language python %}}
-
required_
arg str - {{% md %}}to test required args{{% /md %}}
- driver str
- {{% md %}}The backend storage driver for Helm. Values are: configmap, secret, memory, sql.{{% /md %}}
-
plugins_
path str - {{% md %}}The path to the helm plugins directory.{{% /md %}}
KubeClientSettings
{{% choosable language csharp %}}
- Burst int
- {{% md %}}Maximum burst for throttle. Default value is 10.{{% /md %}}
- Qps double
- {{% md %}}Maximum queries per second (QPS) to the API server from this client. Default value is 5.{{% /md %}}
-
Rec
Test KubeClient Settings - {{% md %}}{{% /md %}}
{{% choosable language go %}}
- Burst int
- {{% md %}}Maximum burst for throttle. Default value is 10.{{% /md %}}
- Qps float64
- {{% md %}}Maximum queries per second (QPS) to the API server from this client. Default value is 5.{{% /md %}}
-
Rec
Test KubeClient Settings - {{% md %}}{{% /md %}}
{{% choosable language nodejs %}}
- burst number
- {{% md %}}Maximum burst for throttle. Default value is 10.{{% /md %}}
- qps number
- {{% md %}}Maximum queries per second (QPS) to the API server from this client. Default value is 5.{{% /md %}}
-
rec
Test KubeClient Settings - {{% md %}}{{% /md %}}
{{% choosable language python %}}
- burst int
- {{% md %}}Maximum burst for throttle. Default value is 10.{{% /md %}}
- qps float
- {{% md %}}Maximum queries per second (QPS) to the API server from this client. Default value is 5.{{% /md %}}
-
rec_
test KubeClient Settings - {{% md %}}{{% /md %}}
LayeredType
{{% choosable language csharp %}}
-
Other
Helm
Release Settings - {{% md %}}{{% /md %}}
- Thinker string
- {{% md %}}To ask and answer{{% /md %}}
- Answer double
- {{% md %}}The answer to the question{{% /md %}}
-
Plain
Other HelmRelease Settings - {{% md %}}Test how plain types interact{{% /md %}}
- Question string
- {{% md %}}The question already answered{{% /md %}}
-
Recursive
Layered
Type - {{% md %}}{{% /md %}}
{{% choosable language go %}}
-
Other
Helm
Release Settings - {{% md %}}{{% /md %}}
- Thinker string
- {{% md %}}To ask and answer{{% /md %}}
- Answer float64
- {{% md %}}The answer to the question{{% /md %}}
-
Plain
Other HelmRelease Settings - {{% md %}}Test how plain types interact{{% /md %}}
- Question string
- {{% md %}}The question already answered{{% /md %}}
-
Recursive
Layered
Type - {{% md %}}{{% /md %}}
{{% choosable language nodejs %}}
-
other
Helm
Release Settings - {{% md %}}{{% /md %}}
- thinker string
- {{% md %}}To ask and answer{{% /md %}}
- answer number
- {{% md %}}The answer to the question{{% /md %}}
-
plain
Other HelmRelease Settings - {{% md %}}Test how plain types interact{{% /md %}}
- question string
- {{% md %}}The question already answered{{% /md %}}
-
recursive
Layered
Type - {{% md %}}{{% /md %}}
{{% choosable language python %}}
-
other
Helm
Release Settings - {{% md %}}{{% /md %}}
- thinker str
- {{% md %}}To ask and answer{{% /md %}}
- answer float
- {{% md %}}The answer to the question{{% /md %}}
-
plain_
other HelmRelease Settings - {{% md %}}Test how plain types interact{{% /md %}}
- question str
- {{% md %}}The question already answered{{% /md %}}
-
recursive
Layered
Type - {{% md %}}{{% /md %}}
Package Details
- Repository
- License