Skip to content

Commit

Permalink
Adding launches docs
Browse files Browse the repository at this point in the history
  • Loading branch information
eamonnfaherty committed Apr 23, 2019
1 parent 36b901f commit 2d3b2f5
Showing 1 changed file with 30 additions and 20 deletions.
50 changes: 30 additions & 20 deletions docs/source/puppet/designing_your_manifest.md
Original file line number Diff line number Diff line change
Expand Up @@ -187,38 +187,48 @@ accounts:
- scope:pci
```


### Launches
Description coming soon
Launches allow you to decide which products get provisioned into each account. You link product launches to accounts
using tags or explicit account ids and you can set which regions the products are launched into.

#### Tag based launches
You can specify a launch to occur using ```tags``` in the ```deploy_to``` section of a launch.

Here is an example, it deploys a ```v1``` of a product named ```account-iam``` from the portfolio
```example-simple-central-it-team-portfolio``` into into the ```default_region``` of all accounts tagged ```type:prod```:

### Example
```yaml
schema: puppet-2019-04-01

accounts:
- account_id: '<YOUR_ACCOUNT_ID>'
name: '<YOUR_ACCOUNT_NAME>'
default_region: us-east-1
regions_enabled:
- us-east-1
- us-west-2
tags:
- type:prod
- partition:us
- scope:pci

launches:
account-iam-for-prod:
portfolio: example-simple-central-it-team-portfolio
product: account-iam
version: v1
parameters:
RoleName:
default: DevAdmin
Path:
default: /human-roles/
deploy_to:
tags:
- tag: type:prod
regions: default_region
```


#### Account based launches
You can also specify a launch to occur explicity in an account by using the ```accounts``` section in the
```deploy_to``` section of a launch.

Here is an example, it deploys a ```v1``` of a product named ```account-iam``` from the portfolio
```example-simple-central-it-team-portfolio``` into into the ```default_region``` of the accounts ```0123456789010```:

```yaml
schema: puppet-2019-04-01

launches:
account-iam-for-prod:
portfolio: example-simple-central-it-team-portfolio
product: account-iam
version: v1
deploy_to:
accounts:
- account_id: '0123456789010'
regions: default_region
```

0 comments on commit 2d3b2f5

Please sign in to comment.