Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fixing some editorial gaps; ensuring Insights casing #13840

Merged
merged 3 commits into from
Jan 23, 2025
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions content/docs/insights/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,9 +42,10 @@ sections:
cards:
- heading: Discover
link: /docs/insights/concepts/
description: Scan and sync all of your infrastructure to bring it under a single pane of glass, so you can understand the structure and status of your with footprint.
description: Scan and sync all of your infrastructure to bring it under a single pane of glass, so you can understand the structure and status of your footprint.
- heading: Advanced Resource Search
description: Find important insights about your cloud infrastructure using structured queries or natural language Pulumi AI assist to quickly locate resources.
description: Find important insights about your cloud infrastructure using structured queries or natural language via Pulumi AI Assist to quickly locate resources.

link: /docs/insights/search/
- heading: Manage
description: Refactor and structure your infrastructure into logical resource groups that map key insights with business needs.
Expand Down
22 changes: 11 additions & 11 deletions content/docs/insights/accounts.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
title: Accounts
title_tag: Create and manage insights accounts | Pulumi Insights
h1: Create and manage insights accounts
meta_desc: This page describes how to create insights accounts for scanning provider account resources to use within Pulumi Cloud.
title_tag: Create and manage Insights accounts | Pulumi Insights
h1: Create and manage Insights accounts
meta_desc: This page describes how to create Pulumi Insights accounts for scanning provider account resources to use within Pulumi Cloud.
interurban marked this conversation as resolved.
Show resolved Hide resolved
meta_image: /images/docs/meta-images/docs-meta.png
menu:
insights:
Expand All @@ -13,7 +13,7 @@ aliases:
- /docs/pulumi-cloud/insights/import/
---

This document outlines the steps required to create and manage a Pulumi insights account used for scanning provider resources.
This document outlines the steps required to create and manage a Pulumi Insights account used for scanning provider resources.
interurban marked this conversation as resolved.
Show resolved Hide resolved

## Prerequisites

Expand All @@ -28,7 +28,7 @@ This document outlines the steps required to create and manage a Pulumi insights
2. On this page, click the **Create Account** button to access the account creation screen.
3. Select your provider.
{{< notes type="info" >}}
Currently, Pulumi supports AWS, Azure, Oracle Cloud, and Kubernetes as providers for insights accounts.
Currently, Pulumi supports AWS, Azure, Oracle Cloud, and Kubernetes as providers for Insights accounts.
{{< /notes >}}
4. Select or create an ESC environment that has the correct credentials to scan the selected provider.
{{< notes type="info" >}}
Expand All @@ -44,12 +44,12 @@ When scheduled scans are enabled, Pulumi automatically scans the account every 2
8. Click `create`. You should see a success notification and arrive on the details page of the account you have created.

{{< notes type="info" >}}
A scan should be kicked off immediately, if you are creating a new insights account for AWS, see the **child accounts** (one for each region) for scan status.
A scan should be kicked off immediately, if you are creating a new Insights account for AWS, see the **child accounts** (one for each region) for scan status.
{{< /notes >}}

## Account hierarchies

Account hierarchies allow you to organize and manage insights accounts in a structured way. Currently, child accounts can only be created automatically by Pulumi and is only done so in the case of AWS regions. In the future, this feature will be expanded to support creating custom hierarchies, providing more flexibility for structuring accounts, such as for organizing Kubernetes clusters within an Azure subscription.
Account hierarchies allow you to organize and manage Insights accounts in a structured way. Currently, child accounts can only be created automatically by Pulumi and is only done so in the case of AWS regions. In the future, this feature will be expanded to support creating custom hierarchies, providing more flexibility for structuring accounts, such as for organizing Kubernetes clusters within an Azure subscription.

### How child accounts work

Expand All @@ -61,7 +61,7 @@ For example:
* Child account (region): `my-aws-account/us-east-1`
interurban marked this conversation as resolved.
Show resolved Hide resolved
* Sub-child account (K8s cluster): `my-aws-account/us-east-1/my-cluster`

If you scan or delete the `my-aws-account` insights account, Pulumi applies this action to all child accounts. However, you can still scan or delete `my-aws-account/us-east-1` without affecting other children of `my-aws-account` and future scans of `my-aws-account` will no longer include `us-east-1` unless it is updated.
If you scan or delete the `my-aws-account` Insights account, Pulumi applies this action to all child accounts. However, you can still scan or delete `my-aws-account/us-east-1` without affecting other children of `my-aws-account` and future scans of `my-aws-account` will no longer include `us-east-1` unless it is updated.

Key benefits of child accounts include:

Expand Down Expand Up @@ -126,7 +126,7 @@ The AWS scanner for Pulumi Cloud requires access to the AWS account you want to

3. **Create an ESC environment**: Configure it to assume the role via OIDC. See [ESC AWS provider documentation](/docs/pulumi-cloud/access-management/oidc/provider/aws/).

4. **Assign the ESC environment**: Link the ESC environment to your insights account during account creation.
4. **Assign the ESC environment**: Link the ESC environment to your Insights account during account creation.

### Azure

Expand Down Expand Up @@ -161,7 +161,7 @@ values:
{{< notes type="info" >}}
For more details on configuring Azure credentials with ESC, refer to [ESC Azure provider documentation](/docs/pulumi-cloud/access-management/oidc/provider/azure/).
{{< /notes >}}
3. Once the ESC environment is set up with the proper credentials, assign it to your insights account during the account creation phase.
3. Once the ESC environment is set up with the proper credentials, assign it to your Insights account during the account creation phase.

### OCI

Expand Down Expand Up @@ -189,7 +189,7 @@ values:
OCI_PRIVATE_KEY_PATH: "<PRIVATE_KEY_CONTENT>"
```

Once the ESC environment is set up with the proper credentials, assign it to your insights account during the account creation phase.
Once the ESC environment is set up with the proper credentials, assign it to your Insights account during the account creation phase.

### Kubernetes (K8s)

Expand Down
2 changes: 1 addition & 1 deletion content/docs/insights/concepts/how-insights-works.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Once scanning is complete, your resources become available through three main in

1. [Resource Explorer](/docs/insights/search/) provides a structured view of your infrastructure, with capabilities for grouping, filtering, and sorting resources
2. [Resource Search](/docs/insights/search/) enables you to find specific resources or groups of resources
3. Pulumi [AI assist](/docs/insights/get-started/using-resource-explorer/#ai-assist-examples) and Copilot allows natural language queries about your infrastructure, such as "Find all public IP addresses"
3. Pulumi [AI assist](/docs/insights/get-started/using-resource-explorer/#ai-assist-examples) and [Copilot](/docs/pulumi-cloud/copilot/) allow natural language queries about your infrastructure, such as "Find all public IP addresses"

The Resource Explorer interface supports:

Expand Down
Loading