About Updating a Domain
Learn about updating a domain with Oracle WebLogic Server for OKE.
Jenkins Pipeline
Oracle WebLogic Server for OKE deploys Jenkins to the Kubernetes cluster along with your domain, and uses Jenkins Pipeline to deploy applications, patches, and update the domain images.
Jenkins Pipeline, also referred to as Pipeline, is a suite of plugins that
supports implementation and integration of continuous delivery (CI/CD) pipelines into
Jenkins. The definition of the Pipeline is written in a Jenkinsfile
, a
text file that can be committed to a project's source control repository.
The CI/CD Pipeline uses Oracle WebLogic Deploy Tooling (WDT) and Oracle WebLogic Image Tool (WIT) to update the domain to deploy applications, libraries, and resources; apply JDK and WebLogic Server patches; and update an existing image.
See Oracle WebLogic Server Deploy Tooling and Oracle WebLogic Image Tool.
The images are pushed and pulled within the same regions as deployments using Oracle Cloud Infrastructure Registry (OCIR) service. See Overview of Registry.
-
Pipelines can be implemented in code and version controlled.
-
Pipelines can be paused at any stage for user inputs or approval.
-
Pipelines support complex CD requirements that enables forking or joining, looping and executing stages in parallel.
-
Pipelines support domain-specific language (DSL) extension.
Topics:
Pipeline Jobs
Oracle WebLogic Server for OKE has a set of preconfigured jobs to deploy applications and patches.
Table 3-1 Preconfigured Jobs
Job Type | Job Name | Description |
---|---|---|
Main | update-domain |
Deploys and undeploys applications, shared libraries and resources such as Java Messaging Service (JMS) and datasources to a domain. |
Main | sample-app |
Deploys and undeploys applications and the correponding
module Yaml using sample-app.war that is bundled with
the Oracle WebLogic Server for
OKE
solution.
|
Main | jdk-patch |
Applies a new JDK on the source image. |
Main | opatch-update |
Applies OPatches on the source image. |
Main | rebase-full-install |
Creates new image from Fusion Middleware installer, JDK installer, and JDK patches. This job reduces the image size but takes long time to execute as it builds the image from scratch and copies to the existing domain over the new image. |
Child | backup-and-deploy-domain-job This job is applicable only for Model in Image. |
Creates a backup of the Yaml file of the running domain and deploys the changes on the running domain. This job is used by other pipeline jobs and cannot be activated manually. |
Child | test-and-deploy-domain-job This job is applicable only for Domain in Image. |
Uses the new domain image from OCIR to create a test domain and validates if all pods are in running state, and then deploys the new domain image to the currently running domain. This job is used by other pipeline jobs and cannot be activated manually. |
Pipeline Job Stages in Model in Image
The Pipeline jobs go through different stages during build creation. These stages are distinct set of substeps that are performed through the Pipeline. The following section describes the stages of the Pipeline jobs when you are using Model in Image.
To identify a version that uses the Model in Image source type, see the Supported Image column in Patches Included in Oracle WebLogic Server for OKE.
Table 3-2 Stages in Pipeline
Stage | Description | Applicable to Job Type |
---|---|---|
PRE-CHECK |
|
|
BUILD_DOMAIN |
|
|
OCIR_UPLOAD |
Pushes the updated domain image to OCIR. |
|
APPLY_JDK |
|
|
APPLY_WLS_OPATCHES |
|
|
REBASE_FULL_INSTALL |
|
|
DEPLOY_DOMAIN |
If deployment to the running domain fails or the pods do not come up, then the job rollbacks to the previous working image. |
|
DOMAIN_VALIDATION |
If deployment to the running domain fails or the pods do not come up, then the job rollbacks to the previous working image. |
|
Pipeline Job Stages in Domain in Image
The Pipeline jobs go through different stages during build creation. These stages are distinct set of substeps that are performed through the Pipeline. The following section describes the stages of the Pipeline jobs when you are using Domain in Image.
Important:
From Oracle WebLogic Server for OKE release 21.2.2 onwards, Domain in Image is deprecated.Table 3-3 Stages in Pipeline
Stage | Description | Appicable to Job Type |
---|---|---|
PRE-CHECK |
|
|
BUILD_DOMAIN |
|
|
REBASE |
Uses WIT to reduce the image size. |
|
OCIR_UPLOAD |
Pushes the updated domain image to OCIR. |
|
APPLY_JDK |
|
|
APPLY_WLS_OPATCHES |
|
|
REBASE_FULL_INSTALL |
Uses WIT rebase command to create new image with Fusion Middleware installer, JDK installer, JDK patches, WLS OPatches, and the domain copied from source image. |
|
TEST_DOMAIN |
Creates new test domain Yaml and applies the test domain Yaml to the running domain. |
|
TEST_DOMAIN_VALIDATION |
|
|
DEPLOY_DOMAIN |
If deployment to the running domain fails or the pods do not come up, then the job rollbacks to the previous working image. |
|
DOMAIN_VALIDATION |
If deployment to the running domain fails or the pods do not come up, then the job rollbacks to the previous working image. |
|
Project Components
Learn about the different tools and files that you can use to build Jenkins projects for your domain.
Oracle WebLogic Server for OKE creates a private load balancer for your domain, which you use to access the Jenkins console running on the Kubernetes cluster. An NGINX ingress controller is used to route traffic from the private load balancer to Jenkins.
All Jenkins files are found on the shared file system.
/u01/shared/var/jenkins_home
- The Jenkins controller server configuration/u01/shared/scripts/pipeline
- The resources used to run the sample Jenkins job, including scripts and metadata files/u01/shared/scripts/pipeline/samples
- Sample domain metadata files for deploying applications, applying patches, and so on.
To access or modify these files, use the administration compute instance for your domain. This compute instance also includes the following software:
kubectl
- Deploy and manage pods in the Kubernetes cluster for this domain.docker
- Download, modify and update Docker images in Oracle Cloud Infrastructure Registry. Use thelogin
command to connect to the registry.oci
- View, create and update resources in Oracle Cloud Infrastructure.