{"id":49302,"date":"2025-05-07T15:28:16","date_gmt":"2025-05-07T15:28:16","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=49302"},"modified":"2025-07-12T05:56:25","modified_gmt":"2025-07-12T05:56:25","slug":"openshift-tutorials-for-deploymentconfigs","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/openshift-tutorials-for-deploymentconfigs\/","title":{"rendered":"Openshift Tutorials for DeploymentConfigs"},"content":{"rendered":"\n

OpenShift DeploymentConfigs<\/strong> are a core resource in OpenShift used to manage the deployment and lifecycle of applications. While Kubernetes uses Deployments<\/strong> to manage the rolling updates of applications, OpenShift introduces the concept of DeploymentConfigs<\/strong> with additional features specific to OpenShift that help with deployment strategies, triggers, and more.<\/p>\n\n\n\n

Key Differences:<\/h3>\n\n\n\n
Feature<\/strong><\/th>Kubernetes Deployment<\/strong><\/th>OpenShift DeploymentConfig<\/strong><\/th><\/tr><\/thead>
Basic Purpose<\/strong><\/td>Declarative updates to applications.<\/td>Declarative updates with additional features for OpenShift.<\/td><\/tr>
Triggers<\/strong><\/td>Manual updates.<\/td>ImageChange, ConfigChange, Manual triggers.<\/td><\/tr>
Deployment Strategies<\/strong><\/td>Rolling updates by default.<\/td>Rolling, Recreate, and Custom strategies.<\/td><\/tr>
Rollback Support<\/strong><\/td>No automatic rollback, manual intervention required.<\/td>Automatic rollback on failure, making it more resilient.<\/td><\/tr>
Integration with CI\/CD<\/strong><\/td>Standard Kubernetes CI\/CD pipelines.<\/td>Integrated with OpenShift BuildConfig, ImageStreams, and CI\/CD.<\/td><\/tr>
Health Check Mechanism<\/strong><\/td>Standard Kubernetes health checks (readiness and liveness).<\/td>Additional hooks for pre\/post-deployment actions.<\/td><\/tr>
Use Case<\/strong><\/td>Ideal for simpler use cases.<\/td>Ideal for OpenShift-specific workflows and more complex needs.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Key Features of OpenShift DeploymentConfig<\/strong>:<\/h3>\n\n\n\n
    \n
  1. Deployment Strategy<\/strong>:
    DeploymentConfigs allow you to specify different deployment strategies to handle updates:\n
      \n
    • Rolling<\/strong>: The default strategy where the deployment is gradually updated without downtime. Pods are updated one by one, ensuring that some are always running.<\/li>\n\n\n\n
    • Recreate<\/strong>: All the old pods are killed and replaced with new ones at the same time. This is used when you need a clean slate for the deployment.<\/li>\n\n\n\n
    • Custom<\/strong>: Allows you to specify your own custom strategy, for more advanced use cases.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
    • Triggers<\/strong>:
      DeploymentConfigs support various triggers that can automatically initiate a deployment. These include:\n
        \n
      • Image Change Trigger<\/strong>: A new deployment is triggered automatically when the image in the container registry is updated.<\/li>\n\n\n\n
      • Config Change Trigger<\/strong>: A deployment is triggered when there is a change in the DeploymentConfig itself (e.g., a change in environment variables or configuration).<\/li>\n\n\n\n
      • Manual Trigger<\/strong>: A manual deployment is triggered by the user.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
      • Rollback<\/strong>:
        OpenShift provides the ability to rollback<\/strong> to a previous version of the DeploymentConfig if something goes wrong with the current deployment. This is handy for maintaining application stability.<\/li>\n\n\n\n
      • Replicas<\/strong>:
        Like Kubernetes Deployments, DeploymentConfigs manage the number of replicas of the application running. It ensures that the specified number of replicas are maintained, and OpenShift will create, scale, and manage these pods as necessary.<\/li>\n\n\n\n
      • Environment Variables<\/strong>:
        DeploymentConfigs allow you to define environment variables, which can be injected into your application containers. These are often used to provide configuration to the application at runtime.<\/li>\n\n\n\n
      • Health Checks<\/strong>:
        DeploymentConfigs allow you to configure readiness and liveness probes to ensure that pods are running properly. If a pod fails these checks, it is replaced automatically.<\/li>\n\n\n\n
      • Deployment Hooks<\/strong>:
        DeploymentConfigs support hooks<\/strong> that allow you to execute commands at different stages of the deployment lifecycle. For example:\n
          \n
        • Pre-deployment hooks<\/strong>: Run before a new deployment starts.<\/li>\n\n\n\n
        • Post-deployment hooks<\/strong>: Run after a deployment has completed.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n

          Example of a DeploymentConfig YAML:<\/h3>\n\n\n
          apiVersion: apps.openshift.io\/v1\nkind<\/span>: DeploymentConfig\nmetadata<\/span>:\n  name: myapp\nspec<\/span>:\n  replicas: 3<\/span>\n  selector<\/span>:\n    app: myapp\n  template<\/span>:\n    metadata:\n      labels:\n        app: myapp\n    spec<\/span>:\n      containers:\n      - name: myapp-container\n        image<\/span>: myrepo\/myapp:latest\n        ports<\/span>:\n        - containerPort: 8080<\/span>\n  strategy<\/span>:\n    type: Rolling\n  triggers<\/span>:\n    - type: ImageChange\n      imageChangeParams<\/span>:\n        automatic: true<\/span>\n        from<\/span>:\n          kind: ImageStreamTag\n          name<\/span>: \"myapp:latest\"<\/span>\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
          Breakdown of the Example:<\/h3>\n\n\n\n
            \n
          1. Metadata<\/strong>:\n
              \n
            • name<\/code>: The name of the DeploymentConfig, in this case, myapp<\/code>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
            • Spec<\/strong>:\n
                \n
              • replicas<\/code>: The number of instances (pods) of the application to run. In this case, 3 replicas are specified.<\/li>\n\n\n\n
              • selector<\/code>: This selects the pods that this DeploymentConfig manages by the app: myapp<\/code> label.<\/li>\n\n\n\n
              • template<\/code>: Defines the pod template, including the container image and ports. It specifies that the myapp-container<\/code> will be using the myrepo\/myapp:latest<\/code> image and exposing port 8080.<\/li>\n\n\n\n
              • strategy<\/code>: Defines the deployment strategy, here it’s set to Rolling<\/code> for zero-downtime updates.<\/li>\n\n\n\n
              • triggers<\/code>: Configures an image change trigger that automatically triggers a new deployment whenever the myapp:latest<\/code> image in the ImageStream is updated.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n
                Key Differences Between Deployment and DeploymentConfig:<\/h3>\n\n\n\n
                  \n
                • DeploymentConfig<\/strong> has more OpenShift-specific features like triggers (e.g., ImageChange, ConfigChange) and deployment strategies that are optimized for OpenShift.<\/li>\n\n\n\n
                • Deployment<\/strong> is a standard Kubernetes resource and doesn\u2019t include OpenShift-specific features like triggers or the advanced deployment strategies.<\/li>\n\n\n\n
                • In OpenShift, DeploymentConfig<\/strong> is the preferred method for managing deployments of applications, especially for more complex use cases that require integrated triggers or detailed management of deployment processes.<\/li>\n<\/ul>\n\n\n\n
                  When to Use DeploymentConfig in OpenShift:<\/h3>\n\n\n\n
                    \n
                  • When you need advanced deployment strategies<\/strong> and control over the lifecycle of your pods.<\/li>\n\n\n\n
                  • When you need automatic triggers<\/strong> (like ImageChange triggers) to trigger deployments based on image changes.<\/li>\n\n\n\n
                  • When working within the OpenShift ecosystem and utilizing OpenShift-specific features<\/strong> like deployment hooks, rollback support, and integrated build and image stream workflows.<\/li>\n<\/ul>\n\n\n\n
                    Note<\/strong>: While DeploymentConfig<\/strong> is used in OpenShift, it is worth noting that Kubernetes has moved more toward using Deployments<\/strong> as the standard for managing workloads. OpenShift still supports DeploymentConfig for compatibility and its additional features.<\/p>\n\n\n\n
                    The difference between Kubernetes Deployments<\/strong> and OpenShift DeploymentConfigs<\/strong> can be subtle, but there are significant distinctions, especially when comparing them in the context of OpenShift, which builds on Kubernetes and adds its own features.<\/p>\n\n\n\n
                    Here\u2019s a detailed comparison:<\/p>\n\n\n\n
                    1. Deployment (Kubernetes)<\/strong>:<\/h3>\n\n\n\n
                    A Kubernetes Deployment<\/strong> is a resource that provides declarative updates to applications. It ensures that the desired number of replicas of a pod are running and automatically manages the rolling updates of the application. Kubernetes Deployments are part of the core Kubernetes API.<\/p>\n\n\n\n
                    Key Features:<\/h4>\n\n\n\n
                      \n
                    • Rolling Updates<\/strong>: Kubernetes Deployment manages the rolling updates, meaning new pods are gradually created, and old ones are terminated, ensuring no downtime.<\/li>\n\n\n\n
                    • Replicas<\/strong>: It controls the desired number of replicas for scaling.<\/li>\n\n\n\n
                    • Pod Health Checks<\/strong>: Deployments use readiness and liveness probes to ensure that pods are healthy and can be restarted if necessary.<\/li>\n\n\n\n
                    • No Triggers<\/strong>: In Kubernetes Deployments, you manually trigger updates or rollbacks (e.g., by changing the image version).<\/li>\n\n\n\n
                    • No Built-in Rollbacks<\/strong>: If a deployment fails, Kubernetes doesn\u2019t automatically revert to the previous state. Rollbacks are done manually by applying the previous deployment configuration.<\/li>\n<\/ul>\n\n\n\n
                      Example of Kubernetes Deployment:<\/h3>\n\n\n
                      apiVersion: apps\/v1\nkind: Deployment\nmetadata:\n  name: myapp\nspec:\n  replicas: 3\n  selector:\n    matchLabels:\n      app: myapp\n  template:\n    metadata:\n      labels:\n        app: myapp\n    spec:\n      containers:\n      - name: myapp-container\n        image: myrepo\/myapp:latest\n        ports:\n        - containerPort: 8080\n<\/code><\/span><\/pre>\n\n\n
                      2. DeploymentConfig (OpenShift)<\/strong>:<\/h3>\n\n\n\n
                      DeploymentConfig<\/strong> is a custom OpenShift resource that is similar to Kubernetes Deployments but with added OpenShift-specific features like deployment triggers<\/strong>, deployment strategies<\/strong>, and rollback mechanisms<\/strong>.<\/p>\n\n\n\n
                      Key Features:<\/h4>\n\n\n\n
                        \n
                      • Triggers<\/strong>:\n
                          \n
                        • Image Change Trigger<\/strong>: Automatically triggers a new deployment whenever the container image is updated (e.g., new version of the image is pushed to the registry).<\/li>\n\n\n\n
                        • Config Change Trigger<\/strong>: Automatically triggers a deployment when the configuration (such as environment variables) changes.<\/li>\n\n\n\n
                        • Manual Trigger<\/strong>: You can manually trigger a deployment.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                        • Deployment Strategies<\/strong>:\n
                            \n
                          • Rolling<\/strong>: Gradual update with zero downtime (like Kubernetes).<\/li>\n\n\n\n
                          • Recreate<\/strong>: All old pods are terminated before new pods are created.<\/li>\n\n\n\n
                          • Custom<\/strong>: Allows you to define your own deployment strategy.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                          • Rollback<\/strong>: OpenShift provides automatic rollback<\/strong> to a previous version if a deployment fails, offering more stability and easier recovery compared to Kubernetes deployments.<\/li>\n\n\n\n
                          • Health Checks<\/strong>: DeploymentConfigs support deployment hooks<\/strong>, which run commands before or after the deployment process.<\/li>\n\n\n\n
                          • Integration with OpenShift Build and Image Streams<\/strong>: OpenShift integrates DeploymentConfigs tightly with its BuildConfig<\/strong> and ImageStream<\/strong> resources. This allows automatic deployment when new images are built using OpenShift\u2019s integrated CI\/CD pipeline.<\/li>\n<\/ul>\n\n\n\n
                            Example of OpenShift DeploymentConfig:<\/h3>\n\n\n
                            apiVersion: apps.openshift.io\/v1\nkind<\/span>: DeploymentConfig\nmetadata<\/span>:\n  name: myapp\nspec<\/span>:\n  replicas: 3<\/span>\n  selector<\/span>:\n    app: myapp\n  template<\/span>:\n    metadata:\n      labels:\n        app: myapp\n    spec<\/span>:\n      containers:\n      - name: myapp-container\n        image<\/span>: myrepo\/myapp:latest\n        ports<\/span>:\n        - containerPort: 8080<\/span>\n  strategy<\/span>:\n    type: Rolling\n  triggers<\/span>:\n    - type: ImageChange\n      imageChangeParams<\/span>:\n        automatic: true<\/span>\n        from<\/span>:\n          kind: ImageStreamTag\n          name<\/span>: \"myapp:latest\"<\/span>\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
                            When to Use Which:<\/h3>\n\n\n\n
                              \n
                            • Kubernetes Deployment<\/strong>: If you\u2019re working with standard Kubernetes and need basic management for application updates with rolling deployments, then Kubernetes Deployment<\/strong> is the way to go.<\/li>\n\n\n\n
                            • OpenShift DeploymentConfig<\/strong>: If you’re working within OpenShift and need more advanced features like automatic rollback, integration with OpenShift\u2019s build system, deployment triggers, and greater flexibility in deployment strategies, then DeploymentConfig<\/strong> is a better option.<\/li>\n<\/ul>\n\n\n\n
                              Summary:<\/h3>\n\n\n\n
                                \n
                              • Kubernetes Deployment<\/strong> is part of the Kubernetes core API, providing basic deployment functionality.<\/li>\n\n\n\n
                              • OpenShift DeploymentConfig<\/strong> extends Kubernetes Deployments with OpenShift-specific features like triggers, custom deployment strategies, automatic rollback, and integration with the OpenShift ecosystem (e.g., ImageStreams and BuildConfig).<\/li>\n<\/ul>\n\n\n\n
                                In simple terms:<\/p>\n\n\n\n
                                  \n
                                • Deployment<\/strong> = Standard Kubernetes resource.<\/li>\n\n\n\n
                                • DeploymentConfig<\/strong> = OpenShift\u2019s extended version with additional management features, triggers, and rollback capabilities.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
                                  OpenShift DeploymentConfigs are a core resource in OpenShift used to manage the deployment and lifecycle of applications. While Kubernetes uses Deployments to manage the rolling updates of applications, OpenShift introduces… <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[5153],"tags":[],"class_list":["post-49302","post","type-post","status-publish","format-standard","hentry","category-openshift"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49302","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=49302"}],"version-history":[{"count":1,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49302\/revisions"}],"predecessor-version":[{"id":49303,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49302\/revisions\/49303"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=49302"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=49302"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=49302"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}