diff --git a/website/content/docs/common-workflows/manage-scopes.mdx b/website/content/docs/common-workflows/manage-scopes.mdx index 06e3b946a7..dd4e8c3a35 100644 --- a/website/content/docs/common-workflows/manage-scopes.mdx +++ b/website/content/docs/common-workflows/manage-scopes.mdx @@ -21,7 +21,9 @@ In this example, we're going to create two scopes, a project and an organization An organization lives in the global scope. In this example, we're going to create an organization. In doing so, we're going to opt for automated role creation during scope generation in order to simplify management of the scope by the user. -#### CLI + + + ```bash $ boundary scopes create -scope-id global -name my_org -description 'My frist org' @@ -40,7 +42,9 @@ Scope information: Type: global ``` -#### UI + + + Navigate to the main boundary landing page and choose `new` organization: ![](/img/manage-scopes-org-undefined.png) @@ -51,7 +55,9 @@ Fill in the orgnaization details: Click save and view the org in the main Boundary landing page: ![](/img/manage-scopes-org-defined.png) -#### Terraform + + + ```hcl resource "boundary_scope" "org" { @@ -62,11 +68,17 @@ resource "boundary_scope" "org" { } ``` + + + + ## Create a Project Next, we're going to add a project scope to our organization. Again, we're going to opt for automated role creation to simplify management of this scope. -#### CLI + + + ```bash $ boundary scopes create -scope-id o_0MkQUfE9jA -name my_project -description 'My frist project' @@ -86,7 +98,9 @@ Scope information: Type: org ``` -#### UI + + + Navigate to your org in the UI and click `new` project: ![](/img/manage-scopes-project-undefined.png) @@ -97,7 +111,9 @@ Add the project settings: View the newly created project: ![](/img/manage-scopes-project-defined.png) -#### Terraform + + + ```hcl resource "boundary_scope" "project" { @@ -109,3 +125,7 @@ resource "boundary_scope" "project" { auto_create_role = true } ``` + + + + diff --git a/website/content/docs/common-workflows/manage-targets.mdx b/website/content/docs/common-workflows/manage-targets.mdx index d095831640..f785046f68 100644 --- a/website/content/docs/common-workflows/manage-targets.mdx +++ b/website/content/docs/common-workflows/manage-targets.mdx @@ -20,7 +20,9 @@ For this example, we're going to create a target to access postgres on `localhos 1. The host address is `127.0.0.1` 2. The target port is `:5432` -#### CLI + + + ```bash boundary hosts create static -name postgres -description "Postgres host" -address "127.0.0.1" -host-catalog-id "hcst_1234567890" @@ -45,7 +47,9 @@ Host information: address: 127.0.0.1 ``` -#### UI + + + Navigate to the default host catalog: ![](/img/manage-targets-host-undefined.png) @@ -59,7 +63,9 @@ Fill in the required information about our postgres host: View the host in the catalog: ![](/img/manage-targets-new-host-defined.png) -#### Terraform + + + To define this same host using our Terraform provider: @@ -73,11 +79,17 @@ resource "boundary_host" "postgres" { } ``` + + + + ## Define a Host-Set Host-sets allow us to group hosts of similar interests together. A target works off of host-sets, so even though we are only defining one host in this example, we're going to create a host-set of one host. -#### CLI + + + ```bash boundary host-sets create static -name "postgres" -description "Postgres host set" -host-catalog-id hcst_1234567890 @@ -99,7 +111,9 @@ Host Set information: Type: project ``` -#### UI + + + Navigate to the host catalog and the `host sets` tab, select `Create Host Set` from `manage` dropdown: ![](/img/manage-targets-new-host-set-undefined.png) @@ -110,7 +124,9 @@ Fill in the host-set definition: See the new host set in the host-catalog view: ![](/img/manage-targets-new-host-set-defined.png) -#### Terraform + + + To define this host-set in Terraform: @@ -126,9 +142,15 @@ resource "boundary_host_set" "postgres" { } ``` + + + + ## Define Target -#### CLI + + + ```bash boundary targets create tcp -name 'postgres' -description 'Postgres target' -default-port 5432 -scope-id p_1234567890 -session-connection-limit '-1' @@ -153,7 +175,9 @@ Target information: Default Port: 5432 ``` -#### UI + + + Navigate to your the default project: ![](/img/manage-targets-new-target-project.png) @@ -167,7 +191,9 @@ Fill in the Target info: See the Target in the targets view: ![](/img/manage-targets-new-target-defined.png) -#### Terraform + + + To define this target in Terraform: @@ -186,3 +212,7 @@ resource "boundary_target" "postgres" { ] } ``` + + + +