Pulumi Cloud
Connect Pulumi Cloud to Ploy to see everyone in your Pulumi Cloud organization, the organization role each person holds, and who is in each team. Ploy can also change a member's organization role, add and remove people on a team, and remove people from the organization.
This integration is in beta
The Pulumi Cloud integration is in beta. It was built from Pulumi Cloud's API documentation and has not yet been checked against a live Pulumi Cloud organization, so some details may need adjusting once customers connect it. Beta does not limit what the integration can do.
The first step of setup is a consent checkbox. Ticking it lets Ploy capture redacted error data when a request to Pulumi Cloud fails: the error response Pulumi Cloud sends back, with personal details, tokens and other secrets removed. Ploy uses it only to fix problems with this integration. You must tick the box to continue.
What Ploy reads
Every member of the connected organization, with their Pulumi login, name and when they joined
Each member's organization role (Admin or Member)
Every team in the organization, and who is in it
Pulumi Cloud does not share members' email addresses, so Ploy matches Pulumi Cloud members to people by their login and name. Ploy does not read pending invitations, access tokens, service accounts, custom roles, roles given to a team, stacks or the audit log.
What Ploy can change
Change a member's organization role. Between Admin and Member. A member holds one organization role, so giving another swaps it. Removing Admin makes the person a Member.
Add or remove a person on a team. From the team's page in Ploy. Teams synced from GitHub or another identity provider are managed there, so Pulumi Cloud may refuse the change.
Remove a person from the organization. Removing someone who is already gone counts as done.
Ploy cannot add people to Pulumi Cloud yet. Add them from the organization's Members page in Pulumi Cloud.
Before you start
You need to be an admin of the Pulumi Cloud organization.
In Pulumi Cloud, switch to the organization you want to connect and open Settings, then Access Tokens.
Create an organization access token and give it the Admin role. Organization tokens need the Essentials edition or above. On the free edition, use a personal access token of an organization admin instead; it carries everything its owner can do, so a dedicated admin account is best.
Note when the token expires. If your organization sets a maximum token lifetime, the token must respect it, or Pulumi Cloud refuses it.
Copy the token.
Connect Pulumi Cloud
In Ploy, open Integrations, find Pulumi Cloud and click Connect.
Tick the beta consent checkbox.
Enter your organization name, as it appears in Pulumi Cloud addresses. For example, for
app.pulumi.com/acme, enteracme.Paste the access token.
Click Test connection, then save.
Ploy scans one organization per connection. To scan another organization, add another connection.
Troubleshooting
Pulumi Cloud rejected that token: check the token was copied in full and has not expired or been deleted.
That token cannot read this organization's members: use a token with the Admin role, and check it respects your organization's maximum token lifetime.
Pulumi Cloud could not find that organization: check the organization name in the Pulumi Cloud address bar.