Skip to content

Commit 7a7b1f0

Browse files
authored
Add no-code deployment settings to Rest API docs (#15353)
1 parent a19c719 commit 7a7b1f0

File tree

3 files changed

+23
-4
lines changed

3 files changed

+23
-4
lines changed

content/docs/pulumi-cloud/reference/_index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,7 @@ The Pulumi Cloud REST API is organized into the following resource categories:
5151
- [Resources Under Management](/docs/pulumi-cloud/reference/resources-under-management/) - Query managed resources
5252
- [Schedules](/docs/pulumi-cloud/reference/schedules/) - Configure scheduled tasks
5353
- [Services](/docs/pulumi-cloud/reference/services/) - Interact with service information
54+
- [Stack Config](/docs/pulumi-cloud/reference/stack-config/) - Manage configuration settings for stacks
5455
- [Stack Policy](/docs/pulumi-cloud/reference/stack-policy/) - Apply and manage policy on stacks
5556
- [Stack Tags](/docs/pulumi-cloud/reference/stack-tags/) - Manage metadata tags on stacks
5657
- [Stack Updates](/docs/pulumi-cloud/reference/stack-updates/) - Manage the update lifecycle for stacks

content/docs/pulumi-cloud/reference/deployments/_index.md

Lines changed: 21 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -940,7 +940,9 @@ The Settings object is the top-level configuration for deployment settings that
940940

941941
### SourceContext
942942

943-
The source context contains information about where the source code for your project is located. Currently, only git repos are supported as a source.
943+
The source context contains information about where the source code for your project is located. Currently, git repos or templates are supported as a source.
944+
945+
#### Git
944946

945947
```json
946948
{
@@ -952,8 +954,6 @@ The source context contains information about where the source code for your pro
952954
}
953955
```
954956

955-
#### Properties
956-
957957
| Name | Type | Description |
958958
|---------------|----------------|--------------------------------------------------|
959959
| `git.repoURL` | string | **Optional.** URL of the git repository. |
@@ -962,6 +962,24 @@ The source context contains information about where the source code for your pro
962962
| `git.commit` | string | **Optional.** Hash of the commit to deploy. Mutually exclusive with branch. |
963963
| `git.gitAuth` | object | **Optional.** Authentication information for the git repo. |
964964

965+
#### Template
966+
967+
Using templates as the source for the deployment enables deploying Pulumi programs without having to manage the underlying IaC code.
968+
Leverage [Stack Config](/docs/pulumi-cloud/reference/stack-config/) to manage configuration settings for these template based stacks, including environment settings and secrets management configuration.
969+
970+
```json
971+
{
972+
"template": {
973+
"sourceUrl": "https://github.com/pulumi/templates/kubernetes-aws-yaml"
974+
}
975+
}
976+
```
977+
978+
| Name | Type | Description |
979+
|-------------------------|--------|-----------------------------------------------------------------------------|
980+
| `template.sourceURL` | string | URL of the template. |
981+
| `template.gitAuth` | object | **Optional.** Authentication information for templates hosted in git repos. |
982+
965983
### OperationContext
966984

967985
The operation context describes any context required for Pulumi operations to execute such as pre-run commands and environment variables.

content/docs/pulumi-cloud/reference/stack-config/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ menu:
88
weight: 20
99
---
1010

11-
Stack config endpoints allow you to manage configuration settings for your Pulumi stacks, including environment settings and secrets management configuration. If stack configuration is returned by the API, it used in place of the local stack config file (e.g. `Pulumi.[stack].yaml`).
11+
Stack config endpoints allow you to manage configuration settings for your Pulumi stacks, including environment settings and secrets management configuration. If stack configuration is returned by the API, it is used in place of the local stack config file (e.g. `Pulumi.[stack].yaml`).
1212

1313
## Stack Config Operations
1414

0 commit comments

Comments
 (0)