diff --git a/docs/resources/app.md b/docs/resources/app.md new file mode 100644 index 00000000..8742f0e9 --- /dev/null +++ b/docs/resources/app.md @@ -0,0 +1,65 @@ +--- +# generated by https://github.com/hashicorp/terraform-plugin-docs +page_title: "coder_app Resource - terraform-provider-coder" +subcategory: "" +description: |- + Use this resource to define shortcuts to access applications in a workspace. +--- + +# coder_app (Resource) + +Use this resource to define shortcuts to access applications in a workspace. + +## Example Usage + +```terraform +data "coder_workspace" "me" {} + +resource "coder_agent" "dev" { + os = "linux" + arch = "amd64" + dir = "/workspace" + startup_script = < +## Schema + +### Required + +- `agent_id` (String) The "id" property of a "coder_agent" resource to associate with. + +### Optional + +- `command` (String) A command to run in a terminal opening this app. In the web, this will open in a new tab. In the CLI, this will SSH and execute the command. +- `icon` (String) A URL to an icon that will display in the dashboard. View built-in icons here: https://github.com/coder/coder/tree/main/site/static/icons. Use a built-in icon with `data.coder_workspace.me.access_url + "/icons/"`. +- `id` (String) The ID of this resource. +- `name` (String) A display name to identify the app. +- `target` (String) A URL to be proxied to from inside the workspace. + + diff --git a/examples/resources/coder_app/resource.tf b/examples/resources/coder_app/resource.tf new file mode 100644 index 00000000..23a0464d --- /dev/null +++ b/examples/resources/coder_app/resource.tf @@ -0,0 +1,32 @@ +data "coder_workspace" "me" {} + +resource "coder_agent" "dev" { + os = "linux" + arch = "amd64" + dir = "/workspace" + startup_script = <\"`.", + ForceNew: true, + Optional: true, + ValidateFunc: func(i interface{}, s string) ([]string, []error) { + _, err := url.Parse(s) + if err != nil { + return nil, []error{err} + } + return nil, nil + }, + }, + "name": { + Type: schema.TypeString, + Description: "A display name to identify the app.", + ForceNew: true, + Optional: true, + }, + "target": { + Type: schema.TypeString, + Description: "A URL to be proxied to from inside the workspace. " + + "Either \"command\" or \"target\" may be specified, but not both.", + ForceNew: true, + Optional: true, + ConflictsWith: []string{"command"}, + }, + }, + }, }, } } diff --git a/internal/provider/provider_test.go b/internal/provider/provider_test.go index 3de6fefb..fdb8ce12 100644 --- a/internal/provider/provider_test.go +++ b/internal/provider/provider_test.go @@ -134,3 +134,47 @@ func TestAgentInstance(t *testing.T) { }}, }) } + +func TestApp(t *testing.T) { + t.Parallel() + resource.Test(t, resource.TestCase{ + Providers: map[string]*schema.Provider{ + "coder": provider.New(), + }, + IsUnitTest: true, + Steps: []resource.TestStep{{ + Config: ` + provider "coder" { + } + resource "coder_agent" "dev" { + os = "linux" + arch = "amd64" + } + resource "coder_app" "code-server" { + agent_id = coder_agent.dev.id + name = "code-server" + icon = "builtin:vim" + target = "http://localhost:13337" + } + `, + Check: func(state *terraform.State) error { + require.Len(t, state.Modules, 1) + require.Len(t, state.Modules[0].Resources, 2) + resource := state.Modules[0].Resources["coder_app.code-server"] + require.NotNil(t, resource) + for _, key := range []string{ + "agent_id", + "name", + "icon", + "target", + } { + value := resource.Primary.Attributes[key] + t.Logf("%q = %q", key, value) + require.NotNil(t, value) + require.Greater(t, len(value), 0) + } + return nil + }, + }}, + }) +} pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy