Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
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
22 changes: 11 additions & 11 deletions content/docs/administration/onboarding-guide/choose-subscription.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,14 +19,14 @@ Setting up your Pulumi Cloud account will lay the foundation for onboarding your
Your subscription tier determines the level of support, training, and features available to your team.

{{%notes type="info"%}}
Pulumi’s community has grown to hundreds of thousands of practitioners worldwide. Check out the [Pulumi Community](https://www.pulumi.com/community/) to connect!
Pulumi’s community has grown to hundreds of thousands of practitioners worldwide. Check out the [Pulumi Community](/community/) to connect!
{{%/notes%}}

### Individual and Team tiers

Perfect for smaller teams or getting started. Access community support through GitHub [Discussions](https://github.com/pulumi/pulumi/discussions) and [Issues](https://github.com/pulumi/pulumi/issues), [Community Slack](https://slack.pulumi.com), and free workshops.

You can also make use of the [Pulumi Neo](https://www.pulumi.com/product/neo/), detailed documentation in the [Pulumi Registry](https://www.pulumi.com/registry/), and the [examples repo](https://github.com/pulumi/examples) to help you get started.
You can also make use of the [Pulumi Neo](/product/neo/), detailed documentation in the [Pulumi Registry](/registry/), and the [examples repo](https://github.com/pulumi/examples) to help you get started.

### Enterprise and Business Critical tiers

Expand All @@ -40,11 +40,11 @@ Designed for larger organizations with mission-critical workloads. These tiers i
Access your support through the [support portal](https://support.pulumi.com/hc/en-us) if you're on a premium plan.

{{% notes type="info" %}}
Learn more about the differences between our subscription tiers [here](https://www.pulumi.com/pricing/)
Learn more about the differences between [our subscription tiers](/pricing/).
{{% /notes %}}

{{% notes type="info" %}}
For hands-on engineering support, consider Pulumi Professional Services. Our team can help design and implement best practices, build custom providers and components, migrate existing infrastructure, and more. We offer standard packages and custom solutions. [Learn more about Professional Services](https://www.pulumi.com/proserv/).
For hands-on engineering support, consider Pulumi Professional Services. Our team can help design and implement best practices, build custom providers and components, migrate existing infrastructure, and more. We offer standard packages and custom solutions. [Learn more about Professional Services](/proserv/).
{{% /notes %}}

## Choose your deployment model
Expand All @@ -53,19 +53,19 @@ Pulumi Cloud offers two deployment options, each designed for different organiza

### SaaS (Recommended for most organizations)

Choose Pulumi Cloud SaaS if you want the simplest setup with enterprise-grade reliability built in. You get high availability, disaster recovery, and geo-replication out of the box, plus security and compliance features detailed in the [Pulumi Cloud Security Whitepaper](https://www.pulumi.com/security/pulumi-cloud-security-whitepaper). Simply sign up at [pulumi.com](http://pulumi.com) to get started.
Choose Pulumi Cloud SaaS if you want the simplest setup with enterprise-grade reliability built in. You get high availability, disaster recovery, and geo-replication out of the box, plus security and compliance features detailed in the [Pulumi Cloud Security Whitepaper](/security/pulumi-cloud-security-whitepaper). Sign up at [pulumi.com](/) to get started.

### Self-hosted (For regulated or air-gapped environments)

{{% notes type="warning" %}}
Self-hosted Pulumi Cloud is only available for Business Critical customers.
{{% /notes %}}

Choose [self-hosted Pulumi Cloud](https://www.pulumi.com/product/self-hosted/) if you need complete control over your hosting environment. This is ideal for air-gapped environments or customers who require an isolated version of the Pulumi platform. You can deploy anywhere: on-premises, in your cloud account, or any infrastructure you control.
Choose [self-hosted Pulumi Cloud](/product/self-hosted/) if you need complete control over your hosting environment. This is ideal for air-gapped environments or customers who require an isolated version of the Pulumi platform. You can deploy anywhere: on-premises, in your cloud account, or any infrastructure you control.

{{% notes type="info" %}}

To get started with self-hosted Pulumi Cloud, follow the guides to set up your [state backend](https://www.pulumi.com/docs/iac/concepts/state-and-backends/#logging-into-the-aws-s3-backend) and [self-hosting infrastructure](https://www.pulumi.com/docs/administration/self-hosting/)
To get started with self-hosted Pulumi Cloud, follow the [self-hosting infrastructure](/docs/administration/self-hosting/) guide. Because Pulumi Cloud isn't yet available to store state during the initial bootstrap process, you'll need a [DIY backend](/docs/iac/guides/basics/using-a-diy-backend/) to manage state for the deployment that stands up the platform.

{{% /notes %}}

Expand All @@ -79,10 +79,10 @@ Pay monthly with a credit card. This option provides flexibility and is ideal fo

### Annual commitment pricing

Pay upfront with invoicing to access significant cost savings through commitment pricing. This option works well for organizations with predictable usage and established procurement processes. [Contact us](https://www.pulumi.com/contact/) to explore commitment pricing options.
Pay upfront with invoicing to access significant cost savings through commitment pricing. This option works well for organizations with predictable usage and established procurement processes. [Contact us](/contact/) to explore commitment pricing options.

{{% notes type="info" %}}
Both billing options include detailed usage insights through the Billing & usage page in your organization settings. Track IaC resources, deployment minutes, ESC secrets, and download usage history. Only organization administrators and designated [billing administrators](https://www.pulumi.com/docs/pulumi-cloud/access-management/billing-managers/) can access these pages. You'll also receive monthly usage reports via email.
Both billing options include detailed usage insights through the Billing & usage page in your organization settings. Track IaC resources, deployment minutes, ESC secrets, and download usage history. Only organization administrators and designated [billing administrators](/docs/administration/organizations-teams/billing-managers/) can access these pages. You'll also receive monthly usage reports via email.
{{% /notes %}}

## Getting started with your chosen model
Expand All @@ -95,10 +95,10 @@ If you are using a self-hosted installation of the Pulumi platform, the URLs use

### Create your account

Sign up using your email address and password, or connect with your GitHub, GitLab, or Atlassian identity at [app.pulumi.com/signup](https://app.pulumi.com/signup). After signup, you can configure SAML/SSO for team onboarding. Learn more about [account management](https://www.pulumi.com/docs/administration/organizations-teams/teams/).
Sign up using your email address and password, or connect with your GitHub, GitLab, or Atlassian identity at [app.pulumi.com/signup](https://app.pulumi.com/signup). After signup, you can configure SAML/SSO for team onboarding. Learn more about [account management](/docs/administration/organizations-teams/teams/).

### Explore the console

Access the Pulumi Cloud console through the "Sign In" link at [pulumi.com](https://pulumi.com) or go directly to [app.pulumi.com](https://app.pulumi.com/signin). The dashboard provides useful content and links, while the left navigation gives you access to stacks, resources, and settings. Use the search function to find specific resources, and click the sparkle icon to access Pulumi Neo, your AI agent.
Access the Pulumi Cloud console through the "Sign In" link at [pulumi.com](/) or go directly to [app.pulumi.com](https://app.pulumi.com/signin). The dashboard provides useful content and links, while the left navigation gives you access to stacks, resources, and settings. Use the search function to find specific resources, and select the sparkle icon to access Pulumi Neo, your AI agent.

{{< get-started-stepper >}}
Original file line number Diff line number Diff line change
Expand Up @@ -15,21 +15,21 @@ Successfully migrating to Pulumi requires strategic decisions about your migrati

## Migrating existing infrastructure

If you have existing cloud infrastructure to bring into Pulumi IaC, you have several strategies available.
If you have existing cloud infrastructure to bring into Pulumi IaC, you have multiple strategies available.

### Choose your migration approach

**Start fresh:** Simply throw away existing infrastructure and begin anew. This ensures you can adopt all best practices from the outset without technical debt. This option isn't always practical for business-critical services.
**Start fresh:** Throw away existing infrastructure and begin anew. This ensures you can adopt all best practices from the outset without technical debt. This option isn't always practical for business-critical services.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

image


**Import existing infrastructure:** Pulumi has tools to import any cloud infrastructure regardless of how it was created — even manually through cloud consoles. The [Visual Import](https://www.pulumi.com/docs/insights/import/) feature is the recommended approach for importing resources. However, Pulumi also offers tailored migration tools for Terraform, AWS CloudFormation/CDK, Azure ARM, and Kubernetes YAML. These tools generate Pulumi IaC code in your chosen language and actively place existing resource management under Pulumi IaC, swapping out management without disrupting resources for zero downtime.
**Import existing infrastructure:** Pulumi has tools to import any cloud infrastructure — including resources created manually through cloud consoles. The [Visual Import](/docs/insights/discovery/visual-import/) feature is the recommended approach for importing resources. However, Pulumi also offers tailored migration tools for Terraform, AWS CloudFormation/CDK, Azure ARM, and Kubernetes YAML. These tools generate Pulumi IaC code in your chosen language and actively place existing resource management under Pulumi IaC, swapping out management without disrupting resources for zero downtime.

**Coexist and migrate incrementally:** Pulumi supports coexisting with existing ecosystems. You can deploy Helm charts as-is or consume Terraform workspace outputs. This enables incremental migration over time when the value is right.

**Get professional help:** Pulumi offers professional services to help with migration.

{{% notes type="info" %}}

Learn more at the [Pulumi Migration Hub](https://www.pulumi.com/docs/iac/adopting-pulumi/migrating-to-pulumi/) or [detailed migration tooling documentation](https://www.pulumi.com/docs/iac/adopting-pulumi/).
Learn more in the [migration guide](/docs/iac/guides/migration/).

{{%/notes%}}

Expand All @@ -51,7 +51,7 @@ These workloads should be automated with CI/CD pipelines and use as many best pr

### Stay focused on impact

**Take a "workload-first" strategy:** Rather than creating dozens of abstractly-useful components, inform specific component requirements from real-world applications emerging from your beachhead win.
**Take a "workload-first" strategy:** Rather than creating dozens of abstractly useful components, inform specific component requirements from real-world applications emerging from your beachhead win.

**Resist the redesign temptation:** Don't conflate redesigning projects with new cloud architectures and platform migration. This adds risk. Get workloads onto Pulumi first, then refactor and redesign in place.

Expand All @@ -60,13 +60,13 @@ These workloads should be automated with CI/CD pipelines and use as many best pr
An internal cloud platform is a product requiring superb developer experiences. While self-service is the primary goal, it's a journey. Start by:

- Getting your platform well-architected
- Documenting components and templates. You can use [Pulumi Cloud IDP](https://www.pulumi.com/product/internal-developer-platforms/) to provide user visibility and access to your templates and components.
- Documenting components and templates. You can use [Pulumi Cloud IDP](/product/internal-developer-platforms/) to provide user visibility and access to your templates and components.
- Instituting an internal open source strategy for collaboration
- Building comprehensive platform capabilities over time

### Don't defer security

Use this moment of change to build security into your platform from day one. Implement Pulumi IaC's Policy as Code features and short-lived cloud credentials with [Pulumi ESC and OIDC](https://www.pulumi.com/docs/esc/integrations/dynamic-login-credentials/). Teams that build up technical debt in this area face costly implications later.
Use this moment of change to build security into your platform from day one. Implement Pulumi IaC's Policy as Code features and short-lived cloud credentials with [Pulumi ESC and OIDC](/docs/esc/integrations/dynamic-login-credentials/). Teams that build up technical debt in this area face costly implications later.

### Measure your success

Expand Down
Loading
Loading