Update glossary (#50)

* Add glossary terms

* add configurable git edit url

* fix CI

* left-justify add this

* li img styling

* define more terms

.gitignore

@@ -6,6 +6,8 @@ node_modules
 .build-harness
 build-harness/
 public/*
+algolia/*
+tmp/*
 .gitkeep
 *.swp
 .idea

Makefile

@@ -2,6 +2,8 @@ export INSTALL_PATH ?= /usr/local/bin
 export HUGO ?= hugo
 export HUGO_VERSION ?= 0.40.2
 export HUGO_URL ?= http://localhost.cloudposse.com:1313/
+export HUGO_EDIT_BRANCH ?= master
+export HUGO_EDIT_URL ?= https://github.com/cloudposse/docs/blob/$(HUGO_EDIT_BRANCH)
 export HUGO_ARGS ?= --watch --buildDrafts
 export HUGO_CONFIG ?= config.toml
 export HUGO_PUBLISH_DIR ?= public
@@ -84,7 +86,8 @@ release:
 	@[ "$(HUGO_CONFIG)" != "config.toml" ] || (echo "Cannot release with $(HUGO_CONFIG)"; exit 1)
 	cat config.toml | \
 		sed 's,^baseURL.*,baseURL = "$(HUGO_URL)",' | \
-		sed 's,^publishDir.*,publishDir = "$(HUGO_PUBLISH_DIR)",' \
+		sed 's,^publishDir.*,publishDir = "$(HUGO_PUBLISH_DIR)",' | \
+		sed 's,^editURL.*,editURL = "$(HUGO_EDIT_URL)",' \
 		> $(HUGO_CONFIG)
 	@echo "Wrote $(HUGO_CONFIG) for $(HUGO_URL)..."
 

codefresh.yml

@@ -33,6 +33,8 @@ steps:
     title: Running tests...
     image: cloudposse/build-harness:${{BUILD_HARNESS_VERSION}}
     working_directory: ./
+    environment:
+      - "HUGO_EDIT_BRANCH=${{CF_BRANCH}}"
     commands:
       - make deps
       - make smoketest

content/announcements/new-major-release-of-geodesic.md

@@ -6,15 +6,12 @@ tags:
 - geodesic
 - goofys
 - aws-vault
-categories:
-- announcements
 ---
 Geodesic is the fastest way to get up and running with a rock solid, production grade cloud platform leveraging best-of-breed Open Source tools.
 
-This release rips out the complicated dependencies on `Makefiles` that wrapped `helm` and `kops`. Our new philosophy is to "Keep things simple, stupid" and not try to wrap all commands under one umbrella. 
+This release rips out the complicated dependencies on `Makefiles` that wrapped `helm` and `kops`. Our new philosophy is to "Keep things simple, stupid" and not try to wrap all commands under one umbrella.
 
 New with this release:
 - `aws-vault` to manage sessions
 - `fstab` to mount S3 buckets with `goofys`
 - `/localhost` maps to caller's `$HOME` directory
-

content/announcements/new-terraform-module-for-kops-to-grant-iam-role-for-external-dns.md

@@ -2,8 +2,6 @@
 title: "Terraform Module to Manage IAM for Kops External DNS"
 description: "Terraform module to provision an IAM role for `external-dns` running in a Kops cluster, and attach an IAM policy to the role with permissions to modify Route53 recordsets."
 publishDate: "2018-03-31 19:40:53"
-categories:
-- announcements
 ---
 
 
@@ -58,4 +56,3 @@ module "kops_external_dns" {
 | `policy_name`      | IAM policy name      |
 | `policy_id`        | IAM policy ID        |
 | `policy_arn`       | IAM policy ARN       |
-

content/development/code-of-conduct.md

@@ -1,6 +1,9 @@
 ---
 title: Code of Conduct
 description: This is our Contributor Covenant Code of Conduct.
+tags:
+- open-source
+- agreement
 ---
 
 # Our Pledge

content/glossary/12-factor.md

@@ -1,11 +1,20 @@
 ---
 title: 12-Factor
-terms: 
+terms:
 - "12f"
 - "12-factor"
 - "12 factor"
 - "12 factor pattern"
 - "12-factor pattern"
-description: ""
+description: "The 12 Factor Pattern is a software methodology for building cloud-friendly (or cloud-native), scalable, maintainable applications that deploy easily on a Platform-as-a-Service (aka PaaS)."
+tags:
+  - cloud native
+  - heroku
 ---
-The 12 Factor Pattern is a software methodology for building cloud-friendly (or cloud-native), scalable, maintainable applications that deploy easily on a Platform-as-a-Service (aka PaaS).
+The 12-Factor pattern is a language agnostic, “Best Practice” for writing Cloud Native applications that can be easily and consistently deployed using Continuous Integration and Continuous Delivery (“CI/CD”).
+
+The pattern can be summed up as:
+- (a) treat all apps as disposable services that receive their configuration via environment variables;
+- (b) rely on backing services to provide durability;
+- (c) script all changes; and
+- (d) treat all environments (dev, prod, qa, etc) as identical.

content/glossary/acm.md

@@ -0,0 +1,11 @@
+---
+title: "Amazon Certificate Manager (ACM)"
+terms:
+  - ACM
+  - Amazon Certificate Manager
+description: "[Amazon Certificate Manager](https://aws.amazon.com/certificate-manager/) is a service that lets you easily provision, manage, and deploy TLS certificates for use with AWS services such as ELBs and CloudFront."
+tags:
+- aws
+- tls
+- pki
+---

content/glossary/ami.md

@@ -0,0 +1,11 @@
+---
+title: "Amazon Machine Image (AMI)"
+description: "An [Amazon Machine Image](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html) provides the information required to launch an EC2 instance, which is a virtual server in the Amazon public cloud."
+terms:
+  - AMI
+  - Amazon Machine Image
+tags:
+  - AWS
+  - EC2
+  - Virtual Machine Image
+---

content/glossary/anti-pattern.md

@@ -0,0 +1,12 @@
+---
+title: "Anti-Pattern"
+description: "An anti-pattern is the opposite of a best-practice."
+terms:
+  - anti pattern
+  - anti patterns
+  - anti-pattern
+  - anti-patterns
+  - bad practice
+  - bad-practice
+---
+An anti-pattern is a common response to a recurring problem that is usually ineffective and risks being highly counterproductive. See [best-practices]({{< relref "glossary/best-practices.md" >}}).

content/glossary/availability-zone.md

@@ -0,0 +1,12 @@
+---
+title: "Availability Zone (AZ)"
+terms:
+  - az
+  - azs
+  - availability zone
+  - availability zones
+  - multi-az
+  - multi-availability zones
+  - multi availability zone
+description: "An [Availability Zone](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-availability-zones) is an isolated data center within a geographic region that is interconnected with other AZs through low-latency links."
+---

content/glossary/aws-vault.md

@@ -1,9 +1,11 @@
 ---
 title: aws-vault
-terms: 
+terms:
 - "aws-vault"
 - "aws vault"
 description: "aws-vault is a utility for securely managing secrets with AWS Systems Manager (SSM) Parameter Store and KMS"
+tags:
+  - aws
+  - IAM
 ---
 `aws-vault` is a utility for securely managing secrets with AWS Systems Manager (SSM) Parameter Store and KMS
-

content/glossary/best-practices.md

@@ -0,0 +1,7 @@
+---
+title: "Best Practices"
+description: "A well-understood and often published technique or methodology that, through experience and research, has proven to reliably lead to a desired result."
+terms:
+- "Best Practice"
+- "Best Practices"
+---

content/glossary/beyondcorp.md

@@ -0,0 +1,9 @@
+---
+title: "BeyondCorp"
+description: "BeyondCorp is an enterprise security model pioneered by Google that enables every employee to work from untrusted networks without the use of a VPN. One critical component is an Identity Aware Proxy."
+terms:
+- BeyondCorp
+tags:
+- IAP
+- Identity Aware Proxy
+---

content/glossary/chamber.md

@@ -0,0 +1,12 @@
+---
+title: "Chamber"
+description: "[Chamber](https://github.com/segmentio/chamber) is a tool by Segment IO for managing secrets with AWS SSM+KMS and exposing them as environment variables."
+terms:
+- Chamber
+tags:
+- aws
+- KMS
+- SSM
+- secrets
+- environment variables
+---

content/glossary/change-control.md

@@ -0,0 +1,10 @@
+---
+title: "Change Management"
+description: "A formal process followed in order to make changes in a document, systematic process."
+terms:
+- change Management
+- change control
+tags:
+- change Management
+- change control
+---

content/glossary/cicd.md

@@ -0,0 +1,13 @@
+---
+title: "Continuous Integration / Continuous Delivery (CI/CD)"
+terms:
+  - ci/cd
+description: 'CI/CD is the practice of combining “Continuous Integration” with “Continuous Delivery” (aka “Continuous Deployment”)'
+tags:
+  - codefresh
+  - travisci
+  - circleci
+  - jenkins
+  - codebuild
+  - codepipeline
+---

content/glossary/cloudfront.md

@@ -0,0 +1,11 @@
+---
+title: CloudFront
+description: 'Amazon CloudFront is a content delivery network (CDN) used to improve latency for end users by hosting cacheable content on distributed global edge locations.'
+terms:
+- CloudFront
+- Cloud Front
+- CF
+tags:
+- AWS
+- CDN
+---

content/glossary/cloudposse.md

@@ -7,6 +7,10 @@ terms:
 - "cloud posse"
 - "cloudposse"
 - "!cloudposse.com"
+- "!cloudposse.net"
+- "!cloudposse.org"
+tags:
+- DevOps
 description: "Cloud Posse is a DevOps professional services company"
 ---
 Cloud Posse is a DevOps professional services company. Let us know how we can help. Reach us at <[email protected]>.

content/glossary/cloudtrail.md

@@ -0,0 +1,11 @@
+---
+title: CloudTrail
+description: ''
+terms:
+- CloudTrail
+- Cloud Trail
+tags:
+- aws
+- security
+- audit logs
+---

content/glossary/cloudwatch-logs.md

@@ -0,0 +1,10 @@
+---
+title: CloudWatch Logs
+description: 'Amazon CloudWatch Logs is a central store for managing logs from AWS cloud resources and applications.'
+terms:
+  - cloudwatch Logs
+tags:
+  - cloudwatch
+  - AWS
+  - fluentd
+---

content/glossary/cloudwatch.md

@@ -0,0 +1,10 @@
+---
+title: "CloudWatch"
+description: "Amazon CloudWatch is a monitoring service for AWS cloud resources and applications."
+terms:
+  - CloudWatch
+  - Cloud Watch
+  - AWS CloudWatch
+tags:
+  - AWS
+---

content/glossary/cmp.md

@@ -0,0 +1,12 @@
+---
+title: "Container Management Platform (CMP)"
+description: ""
+terms:
+- CMP
+- Container Management Platform
+tags:
+- kubernetes
+- ecs
+- mesos
+- cattle
+---

content/glossary/code-build.md

@@ -0,0 +1,12 @@
+---
+title: "CodeBuild"
+description: "[Amazon CodeBuild](https://aws.amazon.com/codebuild/) is a fully managed build service that compiles source code, runs tests, and produces software packages that are ready to deploy. With CodeBuild, you don’t need to provision, manage, and scale your own build servers."
+terms:
+- CodeBuild
+- Code Build
+tags:
+- AWS
+- CodePipeline
+- CI/CD
+---
+CodeBuild scales continuously and processes multiple builds concurrently, so your builds are not left waiting in a queue. Because CodeBuild runs in AWS, it can leverage IAM Instance Profiles to assume roles to securely provision resources without exposing AWS access credentials.

content/glossary/code-deploy.md

@@ -0,0 +1,9 @@
+---
+title: "CodeDeploy"
+description: "Amazon CodeDeploy is a service that automates software deployments to AWS cloud resources."
+terms:
+- CodeDeploy
+- Code Deploy
+tags:
+- AWS
+---

content/glossary/code-pipeline.md

@@ -0,0 +1,11 @@
+---
+title: "CodePipeline"
+description: "[Amazon CodePipeline](https://aws.amazon.com/codepipeline/) is a continuous integration and continuous delivery service for fast and reliable application and infrastructure updates."
+terms:
+- CodePipeline
+- Code Pipeline
+tags:
+- aws
+- CodeBuild
+- CI/code
+---

content/glossary/code-review.md

@@ -0,0 +1,11 @@
+---
+title: "Code Review (CR)"
+description: "A process of reviewing Pull Requests to enable collaboration between team members, improves code quality/stability through creation of alternative solutions to problems, increase transparency through proof of work, increases team awareness by involvement, and improves business continuity through knowledge transfer."
+terms:
+- Code Review
+- CR
+tags:
+- Software development
+- SDLC
+- Pull Request
+---