---
title: Advanced Kubernetes Deployments | Shopware Community Hub
description: >-
  Learn how raw manifests, Helm charts, and GitOps workflows with ArgoCD turn
  Shopware Kubernetes deployments into visible, reusable, and reconciled
  desired…
canonical_url: >-
  https://hub.shopware.comhttps://hub.shopware.com/learn/course/advanced-kubernetes-deployments
---

# Advanced Kubernetes Deployments

# Advanced Kubernetes Deployments

Running Shopware in Kubernetes is not only about creating Pods. A realistic deployment needs configuration, secrets, services, ingress, persistence, reusable packaging, and a clear path for changing the desired state over time.

This course builds on the Kubernetes basics from the previous courses. You start with raw Kubernetes manifests to make every resource responsibility visible. Then you package the same deployment model as a Helm chart. Finally, you connect the chart to ArgoCD and see how GitOps turns commits into reconciled Kubernetes state.

<Callout title="Advanced Kubernetes Is an Optional Operating Path" type="info">

This course is for projects and teams that need to understand or operate Kubernetes deployment models directly. If a managed hosting provider or PaaS already owns this layer, you may not need raw manifests, Helm, or GitOps in daily project work. The concepts still help you discuss responsibilities and trade-offs with platform or hosting teams.

</Callout>

<Callout title="Shopware Kubernetes Tooling" type="info">

This course starts with raw manifests and then builds a small Helm chart so you can see the Kubernetes resource model before it is packaged. For production-oriented Shopware deployments on Kubernetes, also evaluate the actively maintained [Shopware Operator](https://github.com/shopware/shopware-operator) and [Shopware Helm Charts](https://github.com/shopware/helm-charts). They are the recommended direction when a team wants to operate Shopware on Kubernetes instead of maintaining every resource manually.

</Callout>

Throughout the course, the learning flow moves from visible resource ownership to automated reconciliation:

- First, how raw manifests describe the full Shopware deployment model.
- Then, how the same model becomes a working local deployment.
- Then, how Helm turns repeated manifests into a reusable and configurable chart.
- Then, how Helm releases can be installed, upgraded, rolled back, and rendered for different values.
- Then, how GitOps changes the operating model from manual commands to Git as the source of truth.
- And finally, how ArgoCD shows sync, health, drift, and self-healing in the UI and through `kubectl`.

<LearningObjectives>

- Compare raw manifests, Helm, and GitOps as Kubernetes deployment approaches for Shopware.
- Understand how Shopware runtime, configuration, secrets, networking, persistence, and supporting services map to Kubernetes resources.
- Build and deploy a local Shopware stack with raw Kubernetes manifests.
- Create and operate a Shopware Helm chart with values, templates, releases, upgrades, and rollbacks.
- Understand how GitOps changes the deployment workflow from manual cluster changes to reconciled desired state.
- Deploy a Shopware Helm chart through ArgoCD and observe sync, health, drift, and self-healing.

</LearningObjectives>

## Learning Approach

This course combines conceptual learning with three practical labs.

The theory units build the mental models:

- What each Kubernetes resource is responsible for in a Shopware deployment.
- Why raw manifests are useful for understanding, but difficult to reuse at scale.
- How Helm separates a reusable deployment model from environment-specific values.
- Where Helm helps, and which production concerns it does not solve by itself.
- How GitOps uses Git, a controller, reconciliation, drift detection, and self-healing.

The practical labs then make the concepts visible in a local Kubernetes cluster:

- You write and apply raw manifests for a Shopware stack.
- You turn the same resource model into a Helm chart and operate it as a release.
- You push the chart to Git, connect it to ArgoCD, and observe sync, health, drift, and self-healing in the ArgoCD UI and with `kubectl`.

The documented examples use Docker Desktop with Kubernetes, `kubectl`, Helm, Git, ArgoCD, NGINX Ingress, MySQL, Valkey, and a local Shopware image built for the learning path. Docker Desktop is the reference environment for the labs because it keeps the local setup compact. For private learning or educational lab work, it is enough to follow the labs. If you use another local or training Kubernetes cluster, the concepts stay the same, but you may need to adapt image loading, ingress, and service exposure.

By the end of the course, you will not only know the tools, but also how the deployment model evolves: raw manifests make responsibilities visible, Helm makes the model reusable, and GitOps makes the desired state auditable and continuously reconciled.

Ready to connect Kubernetes deployment files, Helm charts, and GitOps workflows in one learning path? Then start with Unit 1 and follow the course from explicit resource ownership to ArgoCD reconciliation.

## Learning Units

## Units
- [Kubernetes Deployment for Shopware](https://hub.shopware.com/learn/unit/kubernetes-deployment-for-shopware): Compare Kubernetes deployment approaches and understand how raw manifests make the resource responsibilities of a Shopware deployment visible.
- [Practical Lab: Deploying Shopware With Raw Kubernetes Manifests](https://hub.shopware.com/learn/unit/practical-lab-deploying-shopware-with-raw-kubernetes-manifests): Build a local Shopware image, write raw Kubernetes manifests, deploy the stack, verify the resources, and clean up the namespace.
- [Helm Charts for Shopware](https://hub.shopware.com/learn/unit/helm-charts-for-shopware): Understand how Helm packages Shopware Kubernetes manifests into reusable, configurable, and release-managed charts.
- [Practical Lab: Creating and Deploying a Shopware Helm Chart](https://hub.shopware.com/learn/unit/practical-lab-creating-and-deploying-a-shopware-helm-chart): Create, deploy, upgrade, roll back, and preview environment values for a local Shopware Helm chart.
- [GitOps for Shopware](https://hub.shopware.com/learn/unit/gitops-for-shopware): Understand how GitOps uses Git, reconciliation, and pull-based controllers to operate Shopware Kubernetes deployments.
- [Practical Lab: Deploying Shopware With GitOps and ArgoCD](https://hub.shopware.com/learn/unit/practical-lab-deploying-shopware-with-gitops-and-argocd): Install ArgoCD, connect it to a Shopware Helm chart repository, sync the release, trigger a Git-based change, observe drift, and clean up.
