This is ${var.stage}!
20 | EOT 21 | } 22 | -------------------------------------------------------------------------------- /03-first-aws-environment/components/terraform/static-site/outputs.tf: -------------------------------------------------------------------------------- 1 | output "domain_name" { 2 | value = module.cdn.cf_domain_name 3 | description = "The FQDN of the created static site." 4 | } 5 | 6 | output "s3_bucket_name" { 7 | value = module.cdn.s3_bucket 8 | description = "The FQDN of the created static site." 9 | } 10 | -------------------------------------------------------------------------------- /03-first-aws-environment/components/terraform/static-site/providers.tf: -------------------------------------------------------------------------------- 1 | provider "aws" { 2 | region = var.region 3 | } 4 | -------------------------------------------------------------------------------- /03-first-aws-environment/components/terraform/static-site/variables.tf: -------------------------------------------------------------------------------- 1 | variable "region" { 2 | type = string 3 | description = "AWS Region" 4 | } 5 | -------------------------------------------------------------------------------- /03-first-aws-environment/components/terraform/static-site/versions.tf: -------------------------------------------------------------------------------- 1 | terraform { 2 | required_version = ">= 1.0.0" 3 | 4 | required_providers { 5 | aws = { 6 | source = "hashicorp/aws" 7 | # Note, we are not upgrading to v5 until this issue is resolved: 8 | # https://github.com/cloudposse/terraform-aws-cloudfront-s3-cdn/issues/279 9 | version = "< 5" 10 | } 11 | } 12 | } 13 | -------------------------------------------------------------------------------- /03-first-aws-environment/components/terraform/tfstate-backend/README.md: -------------------------------------------------------------------------------- 1 | # Component: `tfstate-backend` 2 | 3 | This component is responsible for provisioning an S3 Bucket and DynamoDB table that follow security best practices for usage as a Terraform backend. 4 | 5 | ## Usage 6 | 7 | **Stack Level**: Regional 8 | 9 | Here's an example snippet for how to use this component. 10 | 11 | ```yaml 12 | components: 13 | terraform: 14 | tfstate-backend: 15 | vars: 16 | name: tfstate 17 | force_destroy: false 18 | prevent_unencrypted_uploads: true 19 | enable_server_side_encryption: true 20 | ``` 21 | 22 | 23 | ## Requirements 24 | 25 | | Name | Version | 26 | |------|---------| 27 | | [terraform](#requirement\_terraform) | ~> 0.14.0 | 28 | | [aws](#requirement\_aws) | ~> 3.32 | 29 | | [local](#requirement\_local) | ~> 2.1 | 30 | | [template](#requirement\_template) | ~> 2.2 | 31 | 32 | ## Providers 33 | 34 | No providers. 35 | 36 | ## Modules 37 | 38 | | Name | Source | Version | 39 | |------|--------|---------| 40 | | [tfstate\_backend](#module\_tfstate\_backend) | cloudposse/tfstate-backend/aws | 0.32.0 | 41 | | [this](#module\_this) | cloudposse/label/null | 0.24.1 | 42 | 43 | ## Resources 44 | 45 | No resources. 46 | 47 | ## Inputs 48 | 49 | | Name | Description | Type | Default | Required | 50 | |------|-------------|------|---------|:--------:| 51 | | [additional\_tag\_map](#input\_additional\_tag\_map) | Additional tags for appending to tags\_as\_list\_of\_maps. Not added to `tags`. | `map(string)` | `{}` | no | 52 | | [attributes](#input\_attributes) | Additional attributes (e.g. `1`) | `list(string)` | `[]` | no | 53 | | [context](#input\_context) | Single object for setting entire context at once.object({
enabled = bool
namespace = string
environment = string
stage = string
name = string
delimiter = string
attributes = list(string)
tags = map(string)
additional_tag_map = map(string)
regex_replace_chars = string
label_order = list(string)
id_length_limit = number
}) | {
"additional_tag_map": {},
"attributes": [],
"delimiter": null,
"enabled": true,
"environment": null,
"id_length_limit": null,
"label_order": [],
"name": null,
"namespace": null,
"regex_replace_chars": null,
"stage": null,
"tags": {}
} | no |
54 | | [delimiter](#input\_delimiter) | Delimiter to be used between `namespace`, `environment`, `stage`, `name` and `attributes`.
](https://cpco.io/component)
95 |
--------------------------------------------------------------------------------
/03-first-aws-environment/components/terraform/tfstate-backend/context.tf:
--------------------------------------------------------------------------------
1 | #
2 | # ONLY EDIT THIS FILE IN github.com/cloudposse/terraform-null-label
3 | # All other instances of this file should be a copy of that one
4 | #
5 | #
6 | # Copy this file from https://github.com/cloudposse/terraform-null-label/blob/master/exports/context.tf
7 | # and then place it in your Terraform module to automatically get
8 | # Cloud Posse's standard configuration inputs suitable for passing
9 | # to Cloud Posse modules.
10 | #
11 | # Modules should access the whole context as `module.this.context`
12 | # to get the input variables with nulls for defaults,
13 | # for example `context = module.this.context`,
14 | # and access individual variables as `module.this.`,
15 | # with final values filled in.
16 | #
17 | # For example, when using defaults, `module.this.context.delimiter`
18 | # will be null, and `module.this.delimiter` will be `-` (hyphen).
19 | #
20 |
21 | module "this" {
22 | source = "cloudposse/label/null"
23 | version = "0.24.1" # requires Terraform >= 0.13.0
24 |
25 | enabled = var.enabled
26 | namespace = var.namespace
27 | environment = var.environment
28 | stage = var.stage
29 | name = var.name
30 | delimiter = var.delimiter
31 | attributes = var.attributes
32 | tags = var.tags
33 | additional_tag_map = var.additional_tag_map
34 | label_order = var.label_order
35 | regex_replace_chars = var.regex_replace_chars
36 | id_length_limit = var.id_length_limit
37 |
38 | context = var.context
39 | }
40 |
41 | # Copy contents of cloudposse/terraform-null-label/variables.tf here
42 |
43 | variable "context" {
44 | type = object({
45 | enabled = bool
46 | namespace = string
47 | environment = string
48 | stage = string
49 | name = string
50 | delimiter = string
51 | attributes = list(string)
52 | tags = map(string)
53 | additional_tag_map = map(string)
54 | regex_replace_chars = string
55 | label_order = list(string)
56 | id_length_limit = number
57 | })
58 | default = {
59 | enabled = true
60 | namespace = null
61 | environment = null
62 | stage = null
63 | name = null
64 | delimiter = null
65 | attributes = []
66 | tags = {}
67 | additional_tag_map = {}
68 | regex_replace_chars = null
69 | label_order = []
70 | id_length_limit = null
71 | }
72 | description = <<-EOT
73 | Single object for setting entire context at once.
74 | See description of individual variables for details.
75 | Leave string and numeric variables as `null` to use default value.
76 | Individual variable settings (non-null) override settings in context object,
77 | except for attributes, tags, and additional_tag_map, which are merged.
78 | EOT
79 | }
80 |
81 | variable "enabled" {
82 | type = bool
83 | default = null
84 | description = "Set to false to prevent the module from creating any resources"
85 | }
86 |
87 | variable "namespace" {
88 | type = string
89 | default = null
90 | description = "Namespace, which could be your organization name or abbreviation, e.g. 'eg' or 'cp'"
91 | }
92 |
93 | variable "environment" {
94 | type = string
95 | default = null
96 | description = "Environment, e.g. 'uw2', 'us-west-2', OR 'prod', 'staging', 'dev', 'UAT'"
97 | }
98 |
99 | variable "stage" {
100 | type = string
101 | default = null
102 | description = "Stage, e.g. 'prod', 'staging', 'dev', OR 'source', 'build', 'test', 'deploy', 'release'"
103 | }
104 |
105 | variable "name" {
106 | type = string
107 | default = null
108 | description = "Solution name, e.g. 'app' or 'jenkins'"
109 | }
110 |
111 | variable "delimiter" {
112 | type = string
113 | default = null
114 | description = <<-EOT
115 | Delimiter to be used between `namespace`, `environment`, `stage`, `name` and `attributes`.
116 | Defaults to `-` (hyphen). Set to `""` to use no delimiter at all.
117 | EOT
118 | }
119 |
120 | variable "attributes" {
121 | type = list(string)
122 | default = []
123 | description = "Additional attributes (e.g. `1`)"
124 | }
125 |
126 | variable "tags" {
127 | type = map(string)
128 | default = {}
129 | description = "Additional tags (e.g. `map('BusinessUnit','XYZ')`"
130 | }
131 |
132 | variable "additional_tag_map" {
133 | type = map(string)
134 | default = {}
135 | description = "Additional tags for appending to tags_as_list_of_maps. Not added to `tags`."
136 | }
137 |
138 | variable "label_order" {
139 | type = list(string)
140 | default = null
141 | description = <<-EOT
142 | The naming order of the id output and Name tag.
143 | Defaults to ["namespace", "environment", "stage", "name", "attributes"].
144 | You can omit any of the 5 elements, but at least one must be present.
145 | EOT
146 | }
147 |
148 | variable "regex_replace_chars" {
149 | type = string
150 | default = null
151 | description = <<-EOT
152 | Regex to replace chars with empty string in `namespace`, `environment`, `stage` and `name`.
153 | If not set, `"/[^a-zA-Z0-9-]/"` is used to remove all characters other than hyphens, letters and digits.
154 | EOT
155 | }
156 |
157 | variable "id_length_limit" {
158 | type = number
159 | default = null
160 | description = <<-EOT
161 | Limit `id` to this many characters.
162 | Set to `0` for unlimited length.
163 | Set to `null` for default, which is `0`.
164 | Does not affect `id_full`.
165 | EOT
166 | }
167 |
168 | #### End of copy of cloudposse/terraform-null-label/variables.tf
169 |
--------------------------------------------------------------------------------
/03-first-aws-environment/components/terraform/tfstate-backend/default.auto.tfvars:
--------------------------------------------------------------------------------
1 | # This file is included by default in terraform plans; see Makefile.parent plan commands.
2 |
3 | enabled = true
4 |
--------------------------------------------------------------------------------
/03-first-aws-environment/components/terraform/tfstate-backend/main.tf:
--------------------------------------------------------------------------------
1 | module "tfstate_backend" {
2 | source = "cloudposse/tfstate-backend/aws"
3 | version = "0.32.0" # requires Terraform >= 0.13.0
4 |
5 | force_destroy = var.force_destroy
6 | prevent_unencrypted_uploads = var.prevent_unencrypted_uploads
7 | enable_server_side_encryption = var.enable_server_side_encryption
8 |
9 | context = module.this.context
10 | }
11 |
--------------------------------------------------------------------------------
/03-first-aws-environment/components/terraform/tfstate-backend/outputs.tf:
--------------------------------------------------------------------------------
1 | output "tfstate_backend_s3_bucket_domain_name" {
2 | value = module.tfstate_backend.s3_bucket_domain_name
3 | description = "Terraform state S3 bucket domain name"
4 | }
5 |
6 | output "tfstate_backend_s3_bucket_id" {
7 | value = module.tfstate_backend.s3_bucket_id
8 | description = "Terraform state S3 bucket ID"
9 | }
10 |
11 | output "tfstate_backend_s3_bucket_arn" {
12 | value = module.tfstate_backend.s3_bucket_arn
13 | description = "Terraform state S3 bucket ARN"
14 | }
15 |
16 | output "tfstate_backend_dynamodb_table_name" {
17 | value = module.tfstate_backend.dynamodb_table_name
18 | description = "Terraform state DynamoDB table name"
19 | }
20 |
21 | output "tfstate_backend_dynamodb_table_id" {
22 | value = module.tfstate_backend.dynamodb_table_id
23 | description = "Terraform state DynamoDB table ID"
24 | }
25 |
26 | output "tfstate_backend_dynamodb_table_arn" {
27 | value = module.tfstate_backend.dynamodb_table_arn
28 | description = "Terraform state DynamoDB table ARN"
29 | }
30 |
--------------------------------------------------------------------------------
/03-first-aws-environment/components/terraform/tfstate-backend/providers.tf:
--------------------------------------------------------------------------------
1 | provider "aws" {
2 | region = var.region
3 | }
4 |
--------------------------------------------------------------------------------
/03-first-aws-environment/components/terraform/tfstate-backend/tfstate-context.tf:
--------------------------------------------------------------------------------
1 | variable "tfstate_assume_role" {
2 | type = bool
3 | description = "Set to false to use the caller's role to access the Terraform remote state"
4 | default = true
5 | }
6 |
7 | variable "tfstate_existing_role_arn" {
8 | type = string
9 | description = "The ARN of the existing IAM Role to access the Terraform remote state. If not provided and `remote_state_assume_role` is `true`, a role will be constructed from `remote_state_role_arn_template`"
10 | default = ""
11 | }
12 |
13 | variable "tfstate_account_id" {
14 | type = string
15 | default = ""
16 | description = "The ID of the account where the Terraform remote state backend is provisioned"
17 | }
18 |
19 | variable "tfstate_role_arn_template" {
20 | type = string
21 | default = "arn:aws:iam::%s:role/%s-%s-%s-%s"
22 | description = "IAM Role ARN template for accessing the Terraform remote state"
23 | }
24 |
25 | variable "tfstate_role_environment_name" {
26 | type = string
27 | default = "gbl"
28 | description = "The name of the environment for Terraform state IAM role"
29 | }
30 |
31 | variable "tfstate_role_stage_name" {
32 | type = string
33 | default = "root"
34 | description = "The name of the stage for Terraform state IAM role"
35 | }
36 |
37 | variable "tfstate_bucket_environment_name" {
38 | type = string
39 | default = ""
40 | description = "The name of the environment for Terraform state bucket"
41 | }
42 |
43 | variable "tfstate_bucket_stage_name" {
44 | type = string
45 | default = "root"
46 | description = "The name of the stage for Terraform state bucket"
47 | }
48 |
49 | variable "tfstate_role_name" {
50 | type = string
51 | default = "terraform"
52 | description = "IAM Role name for accessing the Terraform remote state"
53 | }
54 |
55 | locals {
56 | tfstate_access_role_arn = var.tfstate_assume_role ? (
57 | (var.tfstate_existing_role_arn != null && var.tfstate_existing_role_arn != "") ? var.tfstate_existing_role_arn : (
58 | format(var.tfstate_role_arn_template,
59 | var.tfstate_account_id,
60 | module.this.namespace,
61 | var.tfstate_role_environment_name,
62 | var.tfstate_role_stage_name,
63 | var.tfstate_role_name
64 | )
65 | )
66 | ) : null
67 |
68 | tfstate_bucket = "${module.this.namespace}-${var.tfstate_bucket_environment_name}-${var.tfstate_bucket_stage_name}-tfstate"
69 | tfstate_dynamodb_table = "${module.this.namespace}-${var.tfstate_bucket_environment_name}-${var.tfstate_bucket_stage_name}-tfstate-lock"
70 | }
71 |
--------------------------------------------------------------------------------
/03-first-aws-environment/components/terraform/tfstate-backend/variables.tf:
--------------------------------------------------------------------------------
1 | variable "region" {
2 | type = string
3 | description = "AWS Region"
4 | }
5 |
6 | variable "force_destroy" {
7 | type = bool
8 | default = false
9 | description = "A boolean that indicates the terraform state S3 bucket can be destroyed even if it contains objects. These objects are not recoverable."
10 | }
11 |
12 | variable "prevent_unencrypted_uploads" {
13 | type = bool
14 | default = false
15 | description = "Prevent uploads of unencrypted objects to S3"
16 | }
17 |
18 | variable "enable_server_side_encryption" {
19 | type = bool
20 | default = true
21 | description = "Enable DynamoDB and S3 server-side encryption"
22 | }
23 |
--------------------------------------------------------------------------------
/03-first-aws-environment/components/terraform/tfstate-backend/versions.tf:
--------------------------------------------------------------------------------
1 | terraform {
2 | required_version = ">= 1.0.0"
3 |
4 | required_providers {
5 | aws = {
6 | source = "hashicorp/aws"
7 | version = "~> 3.32"
8 | }
9 | local = {
10 | source = "hashicorp/local"
11 | version = "~> 2.1"
12 | }
13 | template = {
14 | source = "cloudposse/template"
15 | version = "~> 2.2"
16 | }
17 | }
18 | }
19 |
--------------------------------------------------------------------------------
/03-first-aws-environment/stacks/catalog/globals.yaml:
--------------------------------------------------------------------------------
1 | vars:
2 | namespace: acme
3 | terraform:
4 | backend_type: s3
5 | backend:
6 | s3:
7 | encrypt: true
8 | bucket: "acme-ue2-root-tfstate-TODO"
9 | key: "terraform.tfstate"
10 | dynamodb_table: "acme-ue2-root-tfstate-lock-TODO"
11 | acl: "bucket-owner-full-control"
12 | region: "us-east-2"
13 |
--------------------------------------------------------------------------------
/03-first-aws-environment/stacks/catalog/uw2-globals.yaml:
--------------------------------------------------------------------------------
1 | vars:
2 | region: us-west-2
3 | environment: uw2
4 |
--------------------------------------------------------------------------------
/03-first-aws-environment/stacks/ue2-root.yaml:
--------------------------------------------------------------------------------
1 | import:
2 | - catalog/globals
3 | vars:
4 | region: us-east-2
5 | environment: ue2
6 | stage: root
7 | components:
8 | terraform:
9 | tfstate-backend:
10 | backend:
11 | s3:
12 | workspace_key_prefix: "tfstate-backend"
13 | vars:
14 | name: tfstate
15 | attributes: [TODO]
16 | force_destroy: false
17 | prevent_unencrypted_uploads: true
18 | enable_server_side_encryption: true
19 |
--------------------------------------------------------------------------------
/03-first-aws-environment/stacks/uw2-dev.yaml:
--------------------------------------------------------------------------------
1 | import:
2 | - catalog/globals
3 | - catalog/uw2-globals
4 | vars:
5 | stage: dev
6 | components:
7 | terraform:
8 | static-site:
9 | vars:
10 | attributes: [TODO]
11 |
--------------------------------------------------------------------------------
/03-first-aws-environment/stacks/uw2-prod.yaml:
--------------------------------------------------------------------------------
1 | import:
2 | - catalog/globals
3 | - catalog/uw2-globals
4 | vars:
5 | stage: prod
6 | components:
7 | terraform:
8 | static-site:
9 | vars:
10 | attributes: [TODO]
11 |
--------------------------------------------------------------------------------
/Dockerfile:
--------------------------------------------------------------------------------
1 | ARG VERSION=latest
2 | ARG OS=debian
3 | ARG CLI_NAME=tutorials
4 | ARG TF_1_VERSION=1.3.10
5 | ARG ATMOS_VERSION=1.50.0
6 |
7 | FROM cloudposse/geodesic:$VERSION-$OS
8 |
9 | ARG TF_1_VERSION
10 | # Install terraform.
11 | RUN apt-get update && apt-get install -y -u --allow-downgrades \
12 | terraform-1="${TF_1_VERSION}-*" && \
13 | update-alternatives --set terraform /usr/share/terraform/1/bin/terraform
14 |
15 | # Install Atmos
16 | ARG ATMOS_VERSION
17 | RUN apt-get install -y --allow-downgrades \
18 | atmos="${ATMOS_VERSION}-*" \
19 | vendir
20 |
21 | # Geodesic message of the Day
22 | ENV MOTD_URL=""
23 |
24 | ENV AWS_VAULT_BACKEND=file
25 |
26 | ENV DOCKER_IMAGE="cloudposse/tutorials"
27 | ENV DOCKER_TAG="latest"
28 |
29 | # Geodesic banner
30 | ENV BANNER="Tutorials"
31 |
32 | COPY rootfs/ /
33 | COPY ./ /tutorials
34 |
35 | WORKDIR /
36 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | Apache License
2 | Version 2.0, January 2004
3 | http://www.apache.org/licenses/
4 |
5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6 |
7 | 1. Definitions.
8 |
9 | "License" shall mean the terms and conditions for use, reproduction,
10 | and distribution as defined by Sections 1 through 9 of this document.
11 |
12 | "Licensor" shall mean the copyright owner or entity authorized by
13 | the copyright owner that is granting the License.
14 |
15 | "Legal Entity" shall mean the union of the acting entity and all
16 | other entities that control, are controlled by, or are under common
17 | control with that entity. For the purposes of this definition,
18 | "control" means (i) the power, direct or indirect, to cause the
19 | direction or management of such entity, whether by contract or
20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the
21 | outstanding shares, or (iii) beneficial ownership of such entity.
22 |
23 | "You" (or "Your") shall mean an individual or Legal Entity
24 | exercising permissions granted by this License.
25 |
26 | "Source" form shall mean the preferred form for making modifications,
27 | including but not limited to software source code, documentation
28 | source, and configuration files.
29 |
30 | "Object" form shall mean any form resulting from mechanical
31 | transformation or translation of a Source form, including but
32 | not limited to compiled object code, generated documentation,
33 | and conversions to other media types.
34 |
35 | "Work" shall mean the work of authorship, whether in Source or
36 | Object form, made available under the License, as indicated by a
37 | copyright notice that is included in or attached to the work
38 | (an example is provided in the Appendix below).
39 |
40 | "Derivative Works" shall mean any work, whether in Source or Object
41 | form, that is based on (or derived from) the Work and for which the
42 | editorial revisions, annotations, elaborations, or other modifications
43 | represent, as a whole, an original work of authorship. For the purposes
44 | of this License, Derivative Works shall not include works that remain
45 | separable from, or merely link (or bind by name) to the interfaces of,
46 | the Work and Derivative Works thereof.
47 |
48 | "Contribution" shall mean any work of authorship, including
49 | the original version of the Work and any modifications or additions
50 | to that Work or Derivative Works thereof, that is intentionally
51 | submitted to Licensor for inclusion in the Work by the copyright owner
52 | or by an individual or Legal Entity authorized to submit on behalf of
53 | the copyright owner. For the purposes of this definition, "submitted"
54 | means any form of electronic, verbal, or written communication sent
55 | to the Licensor or its representatives, including but not limited to
56 | communication on electronic mailing lists, source code control systems,
57 | and issue tracking systems that are managed by, or on behalf of, the
58 | Licensor for the purpose of discussing and improving the Work, but
59 | excluding communication that is conspicuously marked or otherwise
60 | designated in writing by the copyright owner as "Not a Contribution."
61 |
62 | "Contributor" shall mean Licensor and any individual or Legal Entity
63 | on behalf of whom a Contribution has been received by Licensor and
64 | subsequently incorporated within the Work.
65 |
66 | 2. Grant of Copyright License. Subject to the terms and conditions of
67 | this License, each Contributor hereby grants to You a perpetual,
68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69 | copyright license to reproduce, prepare Derivative Works of,
70 | publicly display, publicly perform, sublicense, and distribute the
71 | Work and such Derivative Works in Source or Object form.
72 |
73 | 3. Grant of Patent License. Subject to the terms and conditions of
74 | this License, each Contributor hereby grants to You a perpetual,
75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76 | (except as stated in this section) patent license to make, have made,
77 | use, offer to sell, sell, import, and otherwise transfer the Work,
78 | where such license applies only to those patent claims licensable
79 | by such Contributor that are necessarily infringed by their
80 | Contribution(s) alone or by combination of their Contribution(s)
81 | with the Work to which such Contribution(s) was submitted. If You
82 | institute patent litigation against any entity (including a
83 | cross-claim or counterclaim in a lawsuit) alleging that the Work
84 | or a Contribution incorporated within the Work constitutes direct
85 | or contributory patent infringement, then any patent licenses
86 | granted to You under this License for that Work shall terminate
87 | as of the date such litigation is filed.
88 |
89 | 4. Redistribution. You may reproduce and distribute copies of the
90 | Work or Derivative Works thereof in any medium, with or without
91 | modifications, and in Source or Object form, provided that You
92 | meet the following conditions:
93 |
94 | (a) You must give any other recipients of the Work or
95 | Derivative Works a copy of this License; and
96 |
97 | (b) You must cause any modified files to carry prominent notices
98 | stating that You changed the files; and
99 |
100 | (c) You must retain, in the Source form of any Derivative Works
101 | that You distribute, all copyright, patent, trademark, and
102 | attribution notices from the Source form of the Work,
103 | excluding those notices that do not pertain to any part of
104 | the Derivative Works; and
105 |
106 | (d) If the Work includes a "NOTICE" text file as part of its
107 | distribution, then any Derivative Works that You distribute must
108 | include a readable copy of the attribution notices contained
109 | within such NOTICE file, excluding those notices that do not
110 | pertain to any part of the Derivative Works, in at least one
111 | of the following places: within a NOTICE text file distributed
112 | as part of the Derivative Works; within the Source form or
113 | documentation, if provided along with the Derivative Works; or,
114 | within a display generated by the Derivative Works, if and
115 | wherever such third-party notices normally appear. The contents
116 | of the NOTICE file are for informational purposes only and
117 | do not modify the License. You may add Your own attribution
118 | notices within Derivative Works that You distribute, alongside
119 | or as an addendum to the NOTICE text from the Work, provided
120 | that such additional attribution notices cannot be construed
121 | as modifying the License.
122 |
123 | You may add Your own copyright statement to Your modifications and
124 | may provide additional or different license terms and conditions
125 | for use, reproduction, or distribution of Your modifications, or
126 | for any such Derivative Works as a whole, provided Your use,
127 | reproduction, and distribution of the Work otherwise complies with
128 | the conditions stated in this License.
129 |
130 | 5. Submission of Contributions. Unless You explicitly state otherwise,
131 | any Contribution intentionally submitted for inclusion in the Work
132 | by You to the Licensor shall be under the terms and conditions of
133 | this License, without any additional terms or conditions.
134 | Notwithstanding the above, nothing herein shall supersede or modify
135 | the terms of any separate license agreement you may have executed
136 | with Licensor regarding such Contributions.
137 |
138 | 6. Trademarks. This License does not grant permission to use the trade
139 | names, trademarks, service marks, or product names of the Licensor,
140 | except as required for reasonable and customary use in describing the
141 | origin of the Work and reproducing the content of the NOTICE file.
142 |
143 | 7. Disclaimer of Warranty. Unless required by applicable law or
144 | agreed to in writing, Licensor provides the Work (and each
145 | Contributor provides its Contributions) on an "AS IS" BASIS,
146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 | implied, including, without limitation, any warranties or conditions
148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 | PARTICULAR PURPOSE. You are solely responsible for determining the
150 | appropriateness of using or redistributing the Work and assume any
151 | risks associated with Your exercise of permissions under this License.
152 |
153 | 8. Limitation of Liability. In no event and under no legal theory,
154 | whether in tort (including negligence), contract, or otherwise,
155 | unless required by applicable law (such as deliberate and grossly
156 | negligent acts) or agreed to in writing, shall any Contributor be
157 | liable to You for damages, including any direct, indirect, special,
158 | incidental, or consequential damages of any character arising as a
159 | result of this License or out of the use or inability to use the
160 | Work (including but not limited to damages for loss of goodwill,
161 | work stoppage, computer failure or malfunction, or any and all
162 | other commercial damages or losses), even if such Contributor
163 | has been advised of the possibility of such damages.
164 |
165 | 9. Accepting Warranty or Additional Liability. While redistributing
166 | the Work or Derivative Works thereof, You may choose to offer,
167 | and charge a fee for, acceptance of support, warranty, indemnity,
168 | or other liability obligations and/or rights consistent with this
169 | License. However, in accepting such obligations, You may act only
170 | on Your own behalf and on Your sole responsibility, not on behalf
171 | of any other Contributor, and only if You agree to indemnify,
172 | defend, and hold each Contributor harmless for any liability
173 | incurred by, or claims asserted against, such Contributor by reason
174 | of your accepting any such warranty or additional liability.
175 |
176 | END OF TERMS AND CONDITIONS
177 |
178 | APPENDIX: How to apply the Apache License to your work.
179 |
180 | To apply the Apache License to your work, attach the following
181 | boilerplate notice, with the fields enclosed by brackets "[]"
182 | replaced with your own identifying information. (Don't include
183 | the brackets!) The text should be enclosed in the appropriate
184 | comment syntax for the file format. We also recommend that a
185 | file or class name and description of purpose be included on the
186 | same "printed page" as the copyright notice for easier
187 | identification within third-party archives.
188 |
189 | Copyright [yyyy] [name of copyright owner]
190 |
191 | Licensed under the Apache License, Version 2.0 (the "License");
192 | you may not use this file except in compliance with the License.
193 | You may obtain a copy of the License at
194 |
195 | http://www.apache.org/licenses/LICENSE-2.0
196 |
197 | Unless required by applicable law or agreed to in writing, software
198 | distributed under the License is distributed on an "AS IS" BASIS,
199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 | See the License for the specific language governing permissions and
201 | limitations under the License.
202 |
--------------------------------------------------------------------------------
/Makefile:
--------------------------------------------------------------------------------
1 | SHELL := /bin/bash
2 |
3 | export DOCKER_ORG ?= cloudposse
4 | export DOCKER_IMAGE ?= $(DOCKER_ORG)/tutorials
5 | export DOCKER_TAG ?= latest
6 | export DOCKER_IMAGE_NAME ?= $(DOCKER_IMAGE):$(DOCKER_TAG)
7 | export CONTAINER_NAME ?= tuts
8 |
9 | # List of targets the `readme` target should call before generating the readme
10 | export README_DEPS ?= docs/targets.md
11 |
12 | -include $(shell curl -sSL -o .build-harness "https://cloudposse.tools/build-harness"; echo .build-harness)
13 |
14 | ## Initialize build-harness, install deps, build docker container, install wrapper script and run shell
15 | all: init deps build run
16 | @exit 0
17 |
18 | ## Install dependencies (if any)
19 | deps:
20 | @exit 0
21 |
22 | ## Build docker image
23 | build:
24 | @make --no-print-directory docker/build
25 |
26 | run:
27 | @docker run -it \
28 | --rm \
29 | --volume "$$HOME":/localhost \
30 | --volume "$$PWD":/tutorials \
31 | --name $(CONTAINER_NAME) \
32 | cloudposse/tutorials:latest;
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 |
2 | # Tutorials [](https://github.com/cloudposse/tutorials/releases/latest) [](https://slack.cloudposse.com)
3 |
4 |
5 | [![README Header][readme_header_img]][readme_header_link]
6 |
7 | [![Cloud Posse][logo]](https://cpco.io/homepage)
8 |
9 |
29 |
30 | The tutorial code examples for usage with [docs.cloudposse.com/category/tutorials](https://docs.cloudposse.com/category/tutorials/).
31 |
32 |
33 | ---
34 |
35 | This project is part of our comprehensive ["SweetOps"](https://cpco.io/sweetops) approach towards DevOps.
36 | [
][share_email]
37 | [
][share_googleplus]
38 | [
][share_facebook]
39 | [
][share_reddit]
40 | [
][share_linkedin]
41 | [
][share_twitter]
42 |
43 |
44 |
45 |
46 | It's 100% Open Source and licensed under the [APACHE2](LICENSE).
47 |
48 | ## Introduction
49 |
50 | This tutorials repo is expected to accompany walking through our various getting started tutorials. It provides the hands on code that you can interact with to jumpstart your journey into understanding and utilizing the SweetOps methodology.
51 |
52 | ## Share the Love
53 |
54 | Like this project? Please give it a ★ on [our GitHub](https://github.com/cloudposse/atmos)! (it helps us **a lot**)
55 |
56 | Are you using this project or any of our other projects? Consider [leaving a testimonial][testimonial]. =)
57 |
58 |
59 | ## Related Projects
60 |
61 | Check out these related projects.
62 |
63 | - [docs.cloudposse.com](https://docs.cloudposse.com) - The documentation site for SweetOps
64 | - [docs](https://github.com/cloudposse/docs) - The source for our documentation site
65 | - [atmos](https://github.com/cloudposse/atmos) - Universal Tool for DevOps and Cloud Automation (works with terraform, helm, helmfile, istioctl, etc)
66 | - [Geodesic](https://github.com/cloudposse/geodesic) - 🚀 Geodesic is a DevOps Linux Distro. We use it as a cloud automation shell. It's the fastest way to get up and running with a rock solid Open Source toolchain.
67 | - [terraform-aws-components](https://github.com/cloudposse/terraform-aws-components) - Opinionated, self-contained Terraform root modules that each solve one, specific problem
68 |
69 | ## Help
70 |
71 | **Got a question?** We got answers.
72 |
73 | File a GitHub [issue](https://github.com/cloudposse/atmos/issues), send us an [email][email] or join our [Slack Community][slack].
74 |
75 | [![README Commercial Support][readme_commercial_support_img]][readme_commercial_support_link]
76 |
77 | ## DevOps Accelerator for Startups
78 |
79 |
80 | We are a [**DevOps Accelerator**][commercial_support]. We'll help you build your cloud infrastructure from the ground up so you can own it. Then we'll show you how to operate it and stick around for as long as you need us.
81 |
82 | [][commercial_support]
83 |
84 | Work directly with our team of DevOps experts via email, slack, and video conferencing.
85 |
86 | We deliver 10x the value for a fraction of the cost of a full-time engineer. Our track record is not even funny. If you want things done right and you need it done FAST, then we're your best bet.
87 |
88 | - **Reference Architecture.** You'll get everything you need from the ground up built using 100% infrastructure as code.
89 | - **Release Engineering.** You'll have end-to-end CI/CD with unlimited staging environments.
90 | - **Site Reliability Engineering.** You'll have total visibility into your apps and microservices.
91 | - **Security Baseline.** You'll have built-in governance with accountability and audit logs for all changes.
92 | - **GitOps.** You'll be able to operate your infrastructure via Pull Requests.
93 | - **Training.** You'll receive hands-on training so your team can operate what we build.
94 | - **Questions.** You'll have a direct line of communication between our teams via a Shared Slack channel.
95 | - **Troubleshooting.** You'll get help to triage when things aren't working.
96 | - **Code Reviews.** You'll receive constructive feedback on Pull Requests.
97 | - **Bug Fixes.** We'll rapidly work with you to fix any bugs in our projects.
98 |
99 | ## Slack Community
100 |
101 | Join our [Open Source Community][slack] on Slack. It's **FREE** for everyone! Our "SweetOps" community is where you get to talk with others who share a similar vision for how to rollout and manage infrastructure. This is the best place to talk shop, ask questions, solicit feedback, and work together as a community to build totally *sweet* infrastructure.
102 |
103 | ## Discourse Forums
104 |
105 | Participate in our [Discourse Forums][discourse]. Here you'll find answers to commonly asked questions. Most questions will be related to the enormous number of projects we support on our GitHub. Come here to collaborate on answers, find solutions, and get ideas about the products and services we value. It only takes a minute to get started! Just sign in with SSO using your GitHub account.
106 |
107 | ## Newsletter
108 |
109 | Sign up for [our newsletter][newsletter] that covers everything on our technology radar. Receive updates on what we're up to on GitHub as well as awesome new projects we discover.
110 |
111 | ## Office Hours
112 |
113 | [Join us every Wednesday via Zoom][office_hours] for our weekly "Lunch & Learn" sessions. It's **FREE** for everyone!
114 |
115 | [![zoom](https://img.cloudposse.com/fit-in/200x200/https://cloudposse.com/wp-content/uploads/2019/08/Powered-by-Zoom.png")][office_hours]
116 |
117 | ## Contributing
118 |
119 | ### Bug Reports & Feature Requests
120 |
121 | Please use the [issue tracker](https://github.com/cloudposse/atmos/issues) to report any bugs or file feature requests.
122 |
123 | ### Developing
124 |
125 | If you are interested in being a contributor and want to get involved in developing this project or [help out](https://cpco.io/help-out) with our other projects, we would love to hear from you! Shoot us an [email][email].
126 |
127 | In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow.
128 |
129 | 1. **Fork** the repo on GitHub
130 | 2. **Clone** the project to your own machine
131 | 3. **Commit** changes to your own branch
132 | 4. **Push** your work back up to your fork
133 | 5. Submit a **Pull Request** so that we can review your changes
134 |
135 | **NOTE:** Be sure to merge the latest changes from "upstream" before making a pull request!
136 |
137 |
138 | ## Copyright
139 |
140 | Copyright © 2017-2021 [Cloud Posse, LLC](https://cpco.io/copyright)
141 |
142 |
143 |
144 | ## License
145 |
146 | [](https://opensource.org/licenses/Apache-2.0)
147 |
148 | See [LICENSE](LICENSE) for full details.
149 |
150 | ```text
151 | Licensed to the Apache Software Foundation (ASF) under one
152 | or more contributor license agreements. See the NOTICE file
153 | distributed with this work for additional information
154 | regarding copyright ownership. The ASF licenses this file
155 | to you under the Apache License, Version 2.0 (the
156 | "License"); you may not use this file except in compliance
157 | with the License. You may obtain a copy of the License at
158 |
159 | https://www.apache.org/licenses/LICENSE-2.0
160 |
161 | Unless required by applicable law or agreed to in writing,
162 | software distributed under the License is distributed on an
163 | "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
164 | KIND, either express or implied. See the License for the
165 | specific language governing permissions and limitations
166 | under the License.
167 | ```
168 |
169 |
170 |
171 |
172 |
173 |
174 |
175 |
176 |
177 | ## Trademarks
178 |
179 | All other trademarks referenced herein are the property of their respective owners.
180 |
181 | ## About
182 |
183 | This project is maintained and funded by [Cloud Posse, LLC][website]. Like it? Please let us know by [leaving a testimonial][testimonial]!
184 |
185 | [![Cloud Posse][logo]][website]
186 |
187 | We're a [DevOps Professional Services][hire] company based in Los Angeles, CA. We ❤️ [Open Source Software][we_love_open_source].
188 |
189 | We offer [paid support][commercial_support] on all of our projects.
190 |
191 | Check out [our other projects][github], [follow us on twitter][twitter], [apply for a job][jobs], or [hire us][hire] to help with your cloud strategy and implementation.
192 |
193 |
194 |
195 | ### Contributors
196 |
197 |
198 | | [![Erik Osterman][osterman_avatar]][osterman_homepage]