Infrastructure Code Continuous Delivery Concepts: Difference between revisions
(→Build) |
|||
(9 intermediate revisions by the same user not shown) | |||
Line 21: | Line 21: | ||
==<span id='Activity'></span>Activities== | ==<span id='Activity'></span>Activities== | ||
===Build=== | ===Build=== | ||
The build stage compiles application code and makes the code available for use for other stages. Building is | The build stage compiles application code and makes the code available for use for other stages. Building is done once in a pipeline, every time the source code changes. A core principle of [[Continuous_Delivery#Overview|CD]] is never changing code after the build stage. Building implies the following steps: | ||
* Retrieving build-time dependencies, such as libraries, including those from other projects in the code base and external libraries. | * Retrieving build-time dependencies, such as libraries, including those from other projects in the code base and external libraries. | ||
* Resolving build-time configuration (pulling in configuration files that are shared across multiple projects) | * Resolving build-time configuration (pulling in configuration files that are shared across multiple projects) | ||
* Compiling or transforming the code, such as generating configuration files from templates. | * Compiling or transforming the code, such as generating configuration files from templates. | ||
* Publish [[#Artifact|infrastructure artifacts]] in a delivery repository. | * Publish [[#Artifact|infrastructure artifacts]] in a [[Continuous_Delivery#Delivery_Repository|delivery repository]]. | ||
Conceptually the build stage separates two repository types - the infrastructure code source repository and the delivery repository, which could contain packaged artifacts or raw source code. | Conceptually the build stage separates two repository types - the infrastructure code source repository and the delivery repository, which could contain [[#Infrastructure_Artifacts|packaged artifacts]] or [[#Using_a_Repository_to_Deliver_Infrastructure_Code|raw source code]]. | ||
====Offline and Mock Tests as part of the Build Step==== | ====Offline and Mock Tests as part of the Build Step==== | ||
[[Infrastructure_Code_Testing_Concepts#Offline_Stack_Tests|Offline stack tests]] and [[Infrastructure_Code_Testing_Concepts#Testing_with_Mock_APIs_and_Doubles|tests with mock API and doubles]] do not require provisioning infrastructure so they can be run at build stage. | [[Infrastructure_Code_Testing_Concepts#Offline_Stack_Tests|Offline stack tests]] and [[Infrastructure_Code_Testing_Concepts#Testing_with_Mock_APIs_and_Doubles|tests with mock API and doubles]] do not require provisioning infrastructure so they can be run at build stage. | ||
Line 35: | Line 35: | ||
===Promote=== | ===Promote=== | ||
Promotion means moving code between delivery [[#Stage|stages]]. | Promotion means moving code between delivery [[#Stage|stages]]. Tags or labels could be used with the artifacts to indicated they have been promoted across stages. | ||
===Apply=== | ===Apply=== | ||
An apply activity pulls the infrastructure code or packaged artifacts from a [[Continuous_Delivery#Delivery_Repository|delivery repository]] and applies it to a particular environment, creating infrastructure resources. The infrastructure resources are created in different environments, corresponding to the pipeline stage the activity belongs to: stage testing, integration, production. | |||
===Validate=== | ===Validate=== | ||
Line 44: | Line 46: | ||
===System Integration Testing Stage=== | ===System Integration Testing Stage=== | ||
===Production Stage=== | ===Production Stage=== | ||
=Tools= | =Tools= |
Latest revision as of 02:05, 23 January 2022
External
Internal
Overview
The delivery pipeline metaphor describes how a change in the infrastructure code progresses from the person that makes the change all the way to production.
Reconcile with Continuous Delivery. TO CONTINUE: IaC Chapter 8 Core Practice: Continuously Test and Deliver → Infrastructure Delivery Pipelines.
TO INTEGRATE:
Infrastructure Delivery Pipeline
A infrastructure delivery pipeline consists in multiple types of activities, grouped in stages:
Activities
Build
The build stage compiles application code and makes the code available for use for other stages. Building is done once in a pipeline, every time the source code changes. A core principle of CD is never changing code after the build stage. Building implies the following steps:
- Retrieving build-time dependencies, such as libraries, including those from other projects in the code base and external libraries.
- Resolving build-time configuration (pulling in configuration files that are shared across multiple projects)
- Compiling or transforming the code, such as generating configuration files from templates.
- Publish infrastructure artifacts in a delivery repository.
Conceptually the build stage separates two repository types - the infrastructure code source repository and the delivery repository, which could contain packaged artifacts or raw source code.
Offline and Mock Tests as part of the Build Step
Offline stack tests and tests with mock API and doubles do not require provisioning infrastructure so they can be run at build stage.
Infrastructure Artifacts
Infrastructure code can be assembled into an artifact, which is a package file with a specific format (Python package, RPM, etc.) Not many infrastructure tools have a package format for their code projects. A generic format as ZIP or TAR.GZ could be used, or even Docker images that include stack project code along with the stack tool executable.
Using a Repository to Deliver Infrastructure Code
As an alternative to publishing packaged artifacts, the infrastructure code can be exposed to the next stage of the delivery pipeline directly from the source repository. The code could be stage in a separated delivery source repository.
Promote
Promotion means moving code between delivery stages. Tags or labels could be used with the artifacts to indicated they have been promoted across stages.
Apply
An apply activity pulls the infrastructure code or packaged artifacts from a delivery repository and applies it to a particular environment, creating infrastructure resources. The infrastructure resources are created in different environments, corresponding to the pipeline stage the activity belongs to: stage testing, integration, production.