Merge branch 'OpenLiberty:draft' into draft

OpenLiberty · Mar 20, 2024 · c443083 · c443083
2 parents a4b3606 + 1b3628a
commit c443083
Show file tree

Hide file tree

Showing 131 changed files with 7,963 additions and 57 deletions.
diff --git a/README.md b/README.md
@@ -41,7 +41,7 @@ These steps are to be completed by the author of the blog post.
 
 2. Clone the repo and create a branch off the default `prod` branch. From the `prod` branch, run: `git checkout -b branch_name`, where `branch_name` is a name you give your new branch.
 
-    Do _all_ your editing in this branch so that the blog editors can make any necessary edits directly in the branch before publishing your post.
+    Do _all_ your editing in this branch so that the blog editors can make any necessary edits directly in the branch before publishing your post. You'll push this branch directly to the shared repo (not a fork) in a later step.
 
 3. Create your blog post using [Asciidoc](https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/) markup (use an editor such as [VSCode with the Asciidoc plugin](https://marketplace.visualstudio.com/items?itemName=joaompinto.asciidoctor-vscode)):
 

diff --git a/blog_tags.json b/blog_tags.json
@@ -2,7 +2,8 @@
     "blog_tags": [
         {
             "name": "announcements",
-            "posts": ["24.0.0.1",
+            "posts": ["24.0.0.3", "24.0.0.2",
+                      "24.0.0.2-beta", "24.0.0.1",
                       "24.0.0.1-beta", "liberty-certification",
                       "23.0.0.12", "23.0.0.12-beta",
                       "23.0.0.11", "23.0.0.11-beta",
@@ -75,7 +76,8 @@
             "featured": "true"
         },{
             "name": "microprofile",
-            "posts": ["23.0.0.12", "23.0.0.11",
+            "posts": ["DevNexus24", "24.0.0.2",
+                      "23.0.0.12", "23.0.0.11",
                       "23.0.0.11-beta", "23.0.0.10-beta",
                       "liberty-ide-tools-maven-gradle-plugins-for-java-developers", "23.0.0.6",
                       "rapid-startup-instanton", "23.0.0.5",
@@ -138,7 +140,8 @@
         },
         {
             "name": "java-se",
-            "posts": ["24.0.0.1", "Java21-Images",
+            "posts": ["24.0.0.3",
+                      "24.0.0.1", "Java21-Images",
                       "23.0.0.10", "23.0.0.10-beta",
                       "23.0.0.3", "23.0.0.3-beta",
                       "22.0.0.11", "java-19-22.0.0.10-beta",
@@ -153,7 +156,8 @@
         },
         {
             "name": "release",
-            "posts": ["24.0.0.1",
+            "posts": ["24.0.0.3", "24.0.0.2",
+                      "24.0.0.2-beta", "24.0.0.1",
                       "24.0.0.1-beta", "23.0.0.12",
                       "23.0.0.12-beta","23.0.0.11",
                       "23.0.0.11-beta", "23.0.0.10",
@@ -208,7 +212,8 @@
         },
         {
             "name": "beta",
-            "posts": ["24.0.0.1-beta", "23.0.0.12-beta",
+            "posts": ["24.0.0.2-beta",
+                      "24.0.0.1-beta", "23.0.0.12-beta",
                       "23.0.0.11-beta", "23.0.0.10-beta",
                       "23.0.0.9-beta", "23.0.0.8-beta",
                       "23.0.0.7-beta", "23.0.0.6-beta",
@@ -249,7 +254,9 @@
         },
         {
             "name": "security",
-            "posts": ["24.0.0.1", "23.0.0.12",
+            "posts": ["24.0.0.3",
+                      "DevNexus24", "24.0.0.2-beta",
+                      "24.0.0.1", "23.0.0.12",
                       "23.0.0.10", "23.0.0.10-beta",
                       "23.0.0.9", "23.0.0.8",
                       "23.0.0.6-beta", "22.0.0.13",
@@ -285,7 +292,7 @@
         },
         {
             "name": "docker",
-            "posts": ["23.0.0.6",
+            "posts": ["testcontainers-guide", "23.0.0.6",
                       "23.0.0.4", "23.0.0.2-beta",
                       "using-liberty-buildpack-on-azure-and-google-cloud", "22.0.0.11-beta",
                       "instant-on-beta", "liberty-deep-dive",
@@ -330,7 +337,8 @@
         },
         {
             "name": "jakarta-ee",
-            "posts": ["24.0.0.1-beta", "23.0.0.12-beta",
+            "posts": ["DevNexus24",
+                      "24.0.0.1-beta", "23.0.0.12-beta",
                       "IvarJakartaData", "23.0.0.10-beta",
                       "23.0.0.9-beta",  "23.0.0.8-beta",
                       "liberty-ide-tools-maven-gradle-plugins-for-java-developers",
@@ -379,7 +387,7 @@
         },
         {
             "name": "kubernetes",
-            "posts": ["aws-instant-on",
+            "posts": ["DevNexus24", "aws-instant-on",
                       "using-liberty-buildpack-on-azure-and-google-cloud","instant-on-beta",
                       "liberty-deep-dive", "liberty-devops-ci-cd-jenkins",
                       "kube-secrets-210011", "binding-app-to-postgresql-db-with-odo-and-ol-stack",
@@ -390,7 +398,8 @@
         },
         {
             "name": "community",
-            "posts": ["IvarJakartaData", "Primeur",
+            "posts": ["DevNexus24",
+                      "IvarJakartaData", "Primeur",
                       "kotlin-with-open-liberty", "devnexus",
                       "23.0.0.1", "2022-year-in-review",
                       "relicense-eplv2-proposal", "history-maker-projects",
@@ -416,13 +425,14 @@
         },
         {
             "name": "test",
-            "posts": ["liberty-deep-dive", "MonicaTamboli_MeetTheTeam",
+            "posts": ["testcontainers-guide",
+                      "liberty-deep-dive", "MonicaTamboli_MeetTheTeam",
                       "testing-jakarta-Arquillian-redirect", "eclipse-transformer",
                       "testing-database-connections-REST-APIs", "liberty-dev-mode-vscode"]
         },
         {
             "name": "developer-experience",
-            "posts": ["23.0.0.12",
+            "posts": ["DevNexus24", "23.0.0.12",
                       "23.0.0.8", "23.0.0.7",
                       "liberty-ide-tools-maven-gradle-plugins-for-java-developers", "23.0.0.6",
                       "rapid-startup-instanton", "running-spring-boot-3",
@@ -478,7 +488,8 @@
         },
         {
             "name": "monitoring",
-            "posts": ["Primeur", "23.0.0.3",
+            "posts": ["24.0.0.3",
+                      "Primeur", "23.0.0.3",
                       "tracing-with-microprofile-telemetry", "separate-stack-trace-22008",
                       "separate-stack-trace-22008-beta", "logrecordcontext-22007",
                       "time-based-log-rollover-22007-beta","liberty-deep-dive",
@@ -496,7 +507,8 @@
         },
         {
             "name": "performance-enhancements",
-            "posts": ["Java21-Images", "24.0.0.1",
+            "posts": ["24.0.0.3",
+                      "Java21-Images", "24.0.0.1",
                       "23.0.0.10-beta", "23.0.0.6",
                       "rapid-startup-instanton", "23.0.0.5-beta",
                       "aws-instant-on","instant-on-beta-update",
@@ -525,9 +537,14 @@
                       "simplifying-nosql-database-integration-with-jakarta-nosql"
             ]
         },
+        {
+            "name": "case-study",
+            "posts": [ "Primeur", "production-experience-open-liberty"]
+        },
         {
             "name": "reactive",
-            "posts": [ "23.0.0.11-beta", "reactive-developer-guides",
+            "posts": ["24.0.0.2",
+                      "23.0.0.11-beta", "reactive-developer-guides",
                       "microprofile-reactive-messaging", "microprofile-reactive-messaging-19009",
                       "reactive-microservices-microprofile-19004", "jaxrs-reactive-extensions",
                       "microprofile21-18004"]
@@ -551,7 +568,8 @@
         },
         {
             "name": "devops",
-            "posts": ["23.0.0.6", "rapid-startup-instanton",
+            "posts": ["testcontainers-guide",
+                      "23.0.0.6", "rapid-startup-instanton",
                       "tracing-with-microprofile-telemetry","23.0.0.2-beta",
                       "using-codeengine-with-paketo-buildpack-for-liberty", "memory-footprint-throughput-update",
                       "liberty-deep-dive", "liberty-devops-ci-cd-jenkins"]

diff --git a/img/blog/A-B-testing-kubernetes.png b/img/blog/A-B-testing-kubernetes.png
diff --git a/img/blog/AB-type-1.png b/img/blog/AB-type-1.png
diff --git a/img/blog/AB-type-2-1.png b/img/blog/AB-type-2-1.png
diff --git a/img/blog/AB-type-2.png b/img/blog/AB-type-2.png
diff --git a/img/blog/DevNexus2024.jpg b/img/blog/DevNexus2024.jpg
diff --git a/img/blog/DevNexusJakartaEETrack.jpg b/img/blog/DevNexusJakartaEETrack.jpg
diff --git a/img/blog/DevNexusOLSponsor.png b/img/blog/DevNexusOLSponsor.png
diff --git a/img/blog/KevinSutter-1.jpeg b/img/blog/KevinSutter-1.jpeg
diff --git a/img/blog/KevinSutter-2.jpeg b/img/blog/KevinSutter-2.jpeg
diff --git a/img/blog/KevinSutter-3.jpeg b/img/blog/KevinSutter-3.jpeg
diff --git a/img/blog/KevinSutter-4.jpeg b/img/blog/KevinSutter-4.jpeg
diff --git a/img/blog/KevinSutter-5.jpeg b/img/blog/KevinSutter-5.jpeg
diff --git a/img/blog/OpenShift-deployment.png b/img/blog/OpenShift-deployment.png
diff --git a/img/blog/TestContainers3.png b/img/blog/TestContainers3.png
diff --git a/img/blog/amazon-ec2-security-group-port-mapping.png b/img/blog/amazon-ec2-security-group-port-mapping.png
diff --git a/img/blog/amazon-ec2-target-group-creation.png b/img/blog/amazon-ec2-target-group-creation.png
diff --git a/img/blog/amazon-ecs-openliberty-task-definition-environment.png b/img/blog/amazon-ecs-openliberty-task-definition-environment.png
diff --git a/img/blog/amazon-ecs-openliberty-task-definition.png b/img/blog/amazon-ecs-openliberty-task-definition.png
diff --git a/img/blog/amazon_ecs_hosted_page.png b/img/blog/amazon_ecs_hosted_page.png
diff --git a/img/blog/amazon_ecs_scaled_instances.png b/img/blog/amazon_ecs_scaled_instances.png
diff --git a/img/blog/amazon_ecs_scaling_policy.png b/img/blog/amazon_ecs_scaling_policy.png
diff --git a/img/blog/amazon_ecs_service_health.png b/img/blog/amazon_ecs_service_health.png
diff --git a/img/blog/argocd-image-3.png b/img/blog/argocd-image-3.png
diff --git a/img/blog/argocd-image-4.png b/img/blog/argocd-image-4.png
diff --git a/img/blog/argocd-image1.png b/img/blog/argocd-image1.png
diff --git a/img/blog/argocd-image2.png b/img/blog/argocd-image2.png
diff --git a/img/blog/argocd1.png b/img/blog/argocd1.png
diff --git a/img/blog/argocd2.png b/img/blog/argocd2.png
diff --git a/img/blog/argocd3.png b/img/blog/argocd3.png
diff --git a/img/blog/argocd4.png b/img/blog/argocd4.png
diff --git a/img/blog/bootstrap.png b/img/blog/bootstrap.png
diff --git a/img/blog/config-in-volume-mount.png b/img/blog/config-in-volume-mount.png
diff --git a/img/blog/configmap-command.png b/img/blog/configmap-command.png
diff --git a/img/blog/configmap-env-mapping.png b/img/blog/configmap-env-mapping.png
diff --git a/img/blog/configmap-in-oc1.png b/img/blog/configmap-in-oc1.png
diff --git a/img/blog/configmap-in-oc2.png b/img/blog/configmap-in-oc2.png
diff --git a/img/blog/configmap-yaml.png b/img/blog/configmap-yaml.png
diff --git a/img/blog/configuration-drift-1.png b/img/blog/configuration-drift-1.png
diff --git a/img/blog/configuration-drift-2.png b/img/blog/configuration-drift-2.png
diff --git a/img/blog/configuration-drift-3.png b/img/blog/configuration-drift-3.png
diff --git a/img/blog/configuration-drift-4.png b/img/blog/configuration-drift-4.png
diff --git a/img/blog/configuration-drift-5.png b/img/blog/configuration-drift-5.png
diff --git a/img/blog/configuration-drift-6.png b/img/blog/configuration-drift-6.png
diff --git a/img/blog/configuration-drift-7.png b/img/blog/configuration-drift-7.png
diff --git a/img/blog/configuration-drift-chart.png b/img/blog/configuration-drift-chart.png
diff --git a/img/blog/configuration-drift-outofsync.png b/img/blog/configuration-drift-outofsync.png
diff --git a/img/blog/configuration-drift-synced.png b/img/blog/configuration-drift-synced.png
diff --git a/img/blog/customconfigsource.png b/img/blog/customconfigsource.png
diff --git a/img/blog/dev-cluster.png b/img/blog/dev-cluster.png
diff --git a/img/blog/dev-cluster1.png b/img/blog/dev-cluster1.png
diff --git a/img/blog/devsecops-diagram.png b/img/blog/devsecops-diagram.png
diff --git a/img/blog/dt8pic1.png b/img/blog/dt8pic1.png
diff --git a/img/blog/dt8pic2.png b/img/blog/dt8pic2.png
diff --git a/img/blog/dt8pic3.png b/img/blog/dt8pic3.png
diff --git a/img/blog/dt8pic4.png b/img/blog/dt8pic4.png
diff --git a/img/blog/dt8pic5.png b/img/blog/dt8pic5.png
diff --git a/img/blog/env-variable-results.png b/img/blog/env-variable-results.png
diff --git a/img/blog/environmentalParity.png b/img/blog/environmentalParity.png
diff --git a/img/blog/guideArchitecture.png b/img/blog/guideArchitecture.png
diff --git a/img/blog/microprofile.png b/img/blog/microprofile.png
diff --git a/img/blog/oc-config.png b/img/blog/oc-config.png
diff --git a/img/blog/oc-secret-config-result.png b/img/blog/oc-secret-config-result.png
diff --git a/img/blog/ol-configuration.png b/img/blog/ol-configuration.png
diff --git a/img/blog/ol-configuration1.png b/img/blog/ol-configuration1.png
diff --git a/img/blog/prod-cluster.png b/img/blog/prod-cluster.png
diff --git a/img/blog/prod-cluster1.png b/img/blog/prod-cluster1.png
diff --git a/img/blog/qa-cluster.png b/img/blog/qa-cluster.png
diff --git a/img/blog/qa-cluster1.png b/img/blog/qa-cluster1.png
diff --git a/img/blog/rh_social_media_guide.png b/img/blog/rh_social_media_guide.png
diff --git a/img/blog/rh_social_media_logged_in.png b/img/blog/rh_social_media_logged_in.png
diff --git a/img/blog/rh_social_media_login.png b/img/blog/rh_social_media_login.png
diff --git a/img/blog/rh_social_media_redirect.png b/img/blog/rh_social_media_redirect.png
diff --git a/img/blog/secrets-as-config.png b/img/blog/secrets-as-config.png
diff --git a/img/blog/server-env.png b/img/blog/server-env.png
diff --git a/img/blog/server-xml.png b/img/blog/server-xml.png
diff --git a/img/blog/testcontainers_banner.png b/img/blog/testcontainers_banner.png
diff --git a/posts/2018-07-09-installing-and-upgrading-liberty.adoc b/posts/2018-07-09-installing-and-upgrading-liberty.adoc
@@ -0,0 +1,161 @@
+---
+layout: post
+title: "Installing and upgrading Liberty the right way"
+date:   2018-06-29 11:30:00 -0000
+categories: blog
+author_picture: https://avatars3.githubusercontent.com/u/1999406
+author_github: https://github.com/barecode
+seo-title: Optimizing Spring Boot apps for Docker - OpenLiberty.io
+seo-description: Take a more efficient approach to building Docker images for Spring Boot applications when doing iterative development and deployment. The standard approach has some drawbacks so here we look at what they are and how to do it better.
+blog_description: "Take a more efficient approach to building Docker images for Spring Boot applications when doing iterative development and deployment. The standard approach has some drawbacks so here we look at what they are and how to do it better."
+---
+= Installing and upgrading Liberty the right way
+Michael Thompson <https://github.com/barecode>
+
+This guide lays out the best practice for upgrading Liberty to the latest version in production environments, assuming a normal operating system environment.
+For Docker images, it is recommended that you rebuild your Docker image based on the latest Liberty image available on Docker hub.
+
+
+== Basic Installation
+
+Open Liberty is packaged as a zip.
+At risk of stating the obvious, Liberty can be installed with a simple unzip:
+
+`unzip openliberty-18.0.0.2.zip`
+
+This will lay down the Liberty environment to look like this:
+
+----
+$ ls -l wlp
+total 320
+-rw-r--r--    1 mcthomps  staff   11513 Mar  9 12:23 LICENSE
+-rw-r--r--    1 mcthomps  staff  136756 Jun  8 09:37 NOTICES
+-rw-r--r--    1 mcthomps  staff   11486 Jun 19 05:08 README.TXT
+drwxr-xr-x   24 mcthomps  staff     768 Jun 19 05:08 bin
+drwxr-xr-x    5 mcthomps  staff     160 Jun 19 05:08 clients
+drwxr-xr-x    4 mcthomps  staff     128 Jun 19 05:08 dev
+drwxr-xr-x  455 mcthomps  staff   14560 Jun 19 05:08 lib
+drwxr-xr-x    4 mcthomps  staff     128 Jun 19 05:08 templates
+----
+
+That’s it!
+
+That’s the most basic way to install Liberty.
+When you want to move up to a newer version, you just unzip the new version and move the `usr` directory, which contains all of your apps and configuration.
+
+This is great for development environments or when you are just kicking the tires.
+However, when you are looking at running Liberty for a long time, that is to say in production, there’s a different approach which gives us a more flexibility at the cost of being slightly more complicated.
+
+== Production Installation
+
+In production environments, we recommend taking a few extra setup steps which will end up saving you time in the long run.
+First, you should version the unzip to something like `openliberty-18.0.0.2`.
+This allows for multiple concurrent versions to be available on-disk.
+Second, you should have the applications and configuration stored outside the installation directories.
+
+Let’s look at how to do that.
+
+When you download a version of Open Liberty, it should be extracted to a similarly named directory.
+This allows for multiple versions of Liberty to exist side-by-side.
+
+----
+cd /opt/ol
+curl -sLO https://public.dhe.ibm.com/ibmdl/export/pub/software/openliberty/runtime/release/2018-06-19_0502/openliberty-18.0.0.2.zip
+unzip openliberty-18.0.0.2.zip -d openliberty-18.0.0.2
+----
+
+In my environment there are four Open Liberty installs: 
+
+----
+$ ls -l
+total 196736
+drwxr-xr-x@  8 mcthomps  staff  256 Sep 27  2017 openliberty-17.0.0.3
+drwxr-xr-x@  8 mcthomps  staff  256 Dec  6  2017 openliberty-17.0.0.4
+drwxr-xr-x   3 mcthomps  staff   96 Jun 19 13:22 openliberty-18.0.0.1
+drwxr-xr-x   3 mcthomps  staff   96 Jun 30 06:58 openliberty-18.0.0.2
+----
+
+Should there be any issues with the application after moving it to the latest version of Liberty, you can quickly revert to using a previous version.
+
+Next, create the `usr` directory.
+This directory contains all of the applications and server configuration.
+I tend to use the name `wlp-usr`.
+
+----
+$ mkdir /opt/ol/wlp-usr
+$ ls -l
+total 0
+drwxr-xr-x@  8 mcthomps  staff  256 Sep 27  2017 openliberty-17.0.0.3
+drwxr-xr-x@  8 mcthomps  staff  256 Dec  6  2017 openliberty-17.0.0.4
+drwxr-xr-x   3 mcthomps  staff   96 Jun 19 13:22 openliberty-18.0.0.1
+drwxr-xr-x   3 mcthomps  staff   96 Jun 30 06:58 openliberty-18.0.0.2
+drwxr-xr-x  11 mcthomps  staff  352 Jun 19 15:14 wlp
+drwxr-xr-x   2 mcthomps  staff   64 Jun 30 06:46 wlp-usr----
+----
+
+Lastly, we need to set the environment variable `WLP_USER_DIR` to point to `wlp-usr`.
+This will instruct all of the Liberty commands to look for server configuration there, rather than the default directory.
+
+`export WLP_USER_DIR=/opt/ol/wlp-usr`
+
+== Upgrading the version of the server
+
+If you haven't already, create a server.
+This can be done from any install version.
+This server will be created in the `wlp-usr` directory.
+
+----
+$ cd openliberty-18.0.0.1/wlp
+$ bin/server create
+$ ls /opt/ol/wlp-usr/servers/defaultServer/
+apps            dropins         server.env      server.xml      workarea
+----
+
+Start your server in the foreground with `bin/server run`.
+
+----
+$ bin/server run
+Launching defaultServer (Open Liberty 18.0.0.1/wlp-1.0.20.cl180120180309-2209) on Java HotSpot(TM) 64-Bit Server VM, version 1.8.0_151-b12 (en_US)
+[AUDIT   ] CWWKE0001I: The server defaultServer has been launched.
+[AUDIT   ] CWWKZ0058I: Monitoring dropins for applications.
+[ERROR   ] CWWKO0221E: TCP Channel defaultHttpEndpoint initialization did not succeed.  The socket bind did not succeed for host localhost and port 9080.  The port might already be in use.
+[AUDIT   ] CWWKF0012I: The server installed the following features: [jsp-2.3, servlet-3.1, el-3.0].
+[AUDIT   ] CWWKF0011I: The server defaultServer is ready to run a smarter planet.
+----
+
+Note the version of the server is 18.0.0.1.
+To change the version this server is using, stop the server (ctrl-C), change to a different install version, and start it again.
+
+----
+$ cd /opt/ol/openliberty-18.0.0.2/wlp
+$ bin/server run
+Launching defaultServer (Open Liberty 18.0.0.2/wlp-1.0.21.cl180220180619-0403) on Java HotSpot(TM) 64-Bit Server VM, version 1.8.0_151-b12 (en_US)
+[AUDIT   ] CWWKE0001I: The server defaultServer has been launched.
+[AUDIT   ] CWWKZ0058I: Monitoring dropins for applications.
+[ERROR   ] CWWKO0221E: TCP Channel defaultHttpEndpoint initialization did not succeed.  The socket bind did not succeed for host localhost and port 9080.  The port might already be in use.
+[AUDIT   ] CWWKF0012I: The server installed the following features: [jsp-2.3, servlet-3.1, el-3.0].
+[AUDIT   ] CWWKF0011I: The server defaultServer is ready to run a smarter planet.
+----
+
+That’s it!
+
+Using this file system layout, changing the version of Liberty that is running is as simple as changing the directory you are starting Liberty from.
+
+== Splitting Output
+
+The logs and other output of the server can be split from the configuration using the `WLP_OUTPUT_DIR` environment variable.
+Setting it will cause all of the logs to be written under the specified directory.
+Note that this change only takes affect on server start.
+
+----
+$ mkdir /opt/ol/wlp-output
+$ export WLP_OUTPUT_DIR=/opt/ol/wlp-output
+$ bin/server start
+$ ls /opt/ol/wlp-output/defaultServer/logs/
+console.log     messages.log    state
+----
+
+To preserve these `WLP_USER_DIR` and `WLP_OUTPUT_DIR` environment variables, you will want to set that in your `.bashrc` or create a wrapper script.
+You can also add a server.env to the Liberty install’s etc directory.
+
+For more details on the environment variables and other configuration files which you can use to control Liberty, check out the README.TXT in the install.