Utilizing Kustomize with ArgoCD for Application Deployment
This article is part of a series that explores various facets of using ArgoCD in a GitOps context to manage Kubernetes deployments. From fundamental principles to advanced strategies, this series aims to provide a comprehensive understanding and practical guidance on leveraging ArgoCD effectively.
Table of Contents
- Introduction to GitOps with ArgoCD: Foundations and Architecture
- Utilizing Kustomize with ArgoCD for Application Deployment
- Advanced Deployment Strategies Using ApplicationSets and Application of Applications in ArgoCD
- Unlocking Advanced Image Management with ArgoCD and ArgoCD Image Updater
Introduction
In the realm of Kubernetes, managing and customizing manifests for different environments or configurations can quickly become complex. This is where Kustomize steps in, offering a streamlined approach to configuration customization that integrates seamlessly with ArgoCD, further automating and simplifying application deployments. This blog dives into the Kustomize pattern, outlines its benefits, and provides practical examples of its integration with ArgoCD.
What is Kustomize?
Kustomize introduces a template-free way to customize application configurations. It allows for the modification of Kubernetes manifests without altering the original source files. By using a kustomization.yaml
file, developers can define customizations like image updates, environment-specific configurations, and resource patches.
Understanding Kustomize Structure
Kustomize operates on the principle of having a “base” configuration, which holds the core Kubernetes manifests, and “overlays”, which are modifications specific to each deployment environment. Here’s an example directory structure demonstrating this concept:
/myapp
├── base
│ ├── deployment.yaml
│ └── kustomization.yaml
└── overlays
├── staging
│ ├── deployment-patch.yaml
│ └── kustomization.yaml
└── production
├── deployment-patch.yaml
└── kustomization.yaml
- Base Directory: Contains general Kubernetes manifests that aren’t specific to any environment. The
kustomization.yaml
in this directory includes references to these manifests. - Overlays Directory: Contains subdirectories for each environment (e.g.,
staging
,production
), each with its ownkustomization.yaml
that specifies environment-specific patches or configuration changes.
Example: Modifying the Deployment for Different Environments
Consider you have a basic deployment defined in base/deployment.yaml
. For development (staging
) and production (production
) environments, you want different numbers of replicas and resource limits.
Base Directory
deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: myapp-deployment
spec:
replicas: 1 # default replica count
selector:
matchLabels:
app: myapp
template:
metadata:
labels:
app: myapp
spec:
containers:
- name: myapp-container
image: myapp:1.0.0
resources:
limits:
cpu: "500m"
memory: "512Mi"
requests:
cpu: "250m"
memory: "256Mi"
kustomization.yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- deployment.yaml
Modify Deployment for Different Environments:
overlays/staging/deployment-patch.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: myapp-deployment
spec:
replicas: 2 # increase the number of replicas.
template:
spec:
containers:
- name: myapp-container
resources: # adjust resource requests and limits for testing.
limits:
cpu: "1"
memory: "1Gi"
requests:
cpu: "500m"
memory: "512Mi"
overlays/staging/kustomization.yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
patches:
- path: deployment-patch.yaml
resources:
- ../../base
images:
- name: myapp
newTag: 1.0.0
Adding Applications with the ArgoCD Web UI
The ArgoCD web UI provides a user-friendly way to manage your applications, view their status, and initiate sync operations. Here’s how to add an application using Kustomize directly through the ArgoCD portal:
Create a New Application:
Fill in the Application Details:
- Application Name: Enter a name for your application.
- Project: Select the ArgoCD project where you want to include your application. The default project is usually named “default”.
- Source Repository URL: Input the URL of your Git repository where your Kustomize configuration resides.
- Revision: Specify the branch, tag, or commit SHA to deploy. For the latest version, you can use “HEAD”.
- Path: Enter the path within your repository to the Kustomize overlay directory (e.g.,
myapp/overlays/production
). - Cluster URL: Select or specify the Kubernetes cluster where you want to deploy the application. The internal cluster can usually be referred to as
https://kubernetes.default.svc
. - Namespace: Specify the Kubernetes namespace where the application should be deployed.
Save and Deploy:
- Click the “Create” button to save your application configuration. ArgoCD will then process the Kustomize configuration and deploy your application according to the specified parameters.
Stay tuned for our next entries, where we will not only explore setting up ArgoCD but also delve into advanced deployment strategies using both ApplicationSets and the concept of Application of Applications. Join us as we navigate through these powerful tools to enhance your Kubernetes deployment capabilities with ArgoCD.