oracle-samples · BharathMC · Aug 10, 2026 · Aug 10, 2026 · Aug 10, 2026 · Aug 13, 2026
diff --git a/.gitignore b/.gitignore
@@ -5,6 +5,7 @@ target/
 !**/src/test/**/target/
 
 .DS_Store
+Gemfile.lock
 
 ### STS ###
 .apt_generated

diff --git a/Gemfile b/Gemfile
@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+gem "github-pages", "~> 231", group: :jekyll_plugins
+gem "webrick"
diff --git a/README.md b/README.md
@@ -4,9 +4,11 @@ Oracle Transaction Manager for Microservices (MicroTx) enables enterprise users
 
 Running sample applications is the fastest way for you to get familiar with MicroTx. Sample applications are microservices that demonstrate how you can integrate your applications with MicroTx while using different transaction protocols. The code of the sample applications includes the MicroTx libraries. You can use the sample applications as a reference while using the MicroTx libraries with your custom applications.
 
-## Documentation
-
-See [Documentation set for Oracle Transaction Manager for Microservices](https://docs.oracle.com/en/database/oracle/transaction-manager-for-microservices/index.html).
+## Documentation
+
+See [Documentation set for Oracle Transaction Manager for Microservices](https://docs.oracle.com/en/database/oracle/transaction-manager-for-microservices/index.html).
+
+Read the [Oracle MicroTx Blog](https://oracle-samples.github.io/microtx-samples/) for tutorials, deployment guides, workflow resources, and distributed transaction patterns.
 
 ## Repository Structure for Sample Applications
 
@@ -54,4 +56,4 @@ Please consult the [security guide](./SECURITY.md) for our responsible security
 Copyright (c) 2023 Oracle and/or its affiliates.
 
 Released under the Universal Permissive License v1.0 as shown at
-<https://oss.oracle.com/licenses/upl/>.
+<https://oss.oracle.com/licenses/upl/>.
diff --git a/docs/_config.yml b/docs/_config.yml
@@ -0,0 +1,67 @@
+title: Oracle MicroTx
+description: Practical articles about Oracle Transaction Manager for Microservices.
+seo_keywords:
+  - Agentic AI
+  - AI Agents
+  - Agentic Workflows
+  - AI-Assisted Workflows
+  - AI-Native Workflows
+  - Compensation Patterns
+  - Conductor OSS
+  - Distributed Transactions
+  - Durable Execution
+  - Durable Workflows
+  - Enterprise AI
+  - Enterprise Workflows
+  - Human Approval
+  - Idempotency
+  - Kubernetes
+  - Long-Running Workflows
+  - MCP
+  - Microservices
+  - MicroTx blogs
+  - Oracle Database
+  - Oracle Database 23ai
+  - Oracle Database 26ai
+  - Oracle Transaction Manager for Microservices
+  - Oracle MicroTx
+  - Oracle MicroTx Free
+  - Oracle MicroTx Workflows
+  - Oracle Cloud Marketplace
+  - Oracle Kubernetes Engine
+  - OCI Resource Manager
+  - Production AI
+  - RAG
+  - Runtime Controls
+  - Saga
+  - Systems of Record
+  - TCC
+  - Temporal
+  - Transaction Coordination
+  - Distributed Transaction Coordinator
+  - Workflow Orchestration
+  - XA
+  - LRA
+url: "https://oracle-samples.github.io"
+baseurl: "/microtx-samples"
+lang: en
+timezone: UTC
+permalink: /:title/
+markdown: kramdown
+highlighter: rouge
+
+plugins:
+  - jekyll-feed
+  - jekyll-seo-tag
+  - jekyll-sitemap
+
+defaults:
+  - scope:
+      path: ""
+      type: posts
+    values:
+      layout: post
+
+exclude:
+  - Gemfile
+  - Gemfile.lock
diff --git a/docs/_data/authors.yml b/docs/_data/authors.yml
@@ -0,0 +1,35 @@
+oracle-microtx-team:
+  name: Oracle MicroTx team
+  role: Oracle MicroTx engineering
+  github: https://github.com/oracle-samples
+  linkedin:
+
+bharath-mc:
+  name: BHARATH MC
+  role: Principal Platform Software Engineer – Oracle MicroTx
+  github:
+  linkedin: https://www.linkedin.com/in/bharath-mc-95578061/
+
+pruthvithej-ramesh-kumar:
+  name: Pruthvithej Ramesh Kumar
+  role: Lead Principal Platform Software Engineer – Oracle MicroTx
+  github:
+  linkedin:
+
+brijesh-deo:
+  name: Brijesh Deo
+  role:
+  github:
+  linkedin:
+
+deepak-goel:
+  name: Deepak Goel
+  role: Vice President, Platform Software Engineering
+  github:
+  linkedin:
+
+shivanshu-singh:
+  name: Shivanshu Singh
+  role:
+  github:
+  linkedin:
diff --git a/docs/_data/external_articles.yml b/docs/_data/external_articles.yml
@@ -0,0 +1,108 @@
+- title: How Oracle MicroTx Workflows Makes Enterprise Workflow Execution Durable
+  description: Learn how Oracle MicroTx Workflows combines durable orchestration, Oracle Database persistence, and distributed transactions for resilient enterprise workflows and AI agents.
+  date: 2026-07-06 00:00:00 +0000
+  author_id: pruthvithej-ramesh-kumar
+  external: true
+  url: https://blogs.oracle.com/database/durable-workflow-execution-oracle-microtx-workflows
+  tags:
+    - Oracle MicroTx Workflows
+    - Durable Execution
+    - Durable Workflows
+    - Conductor OSS
+    - Oracle Database
+    - Distributed Transactions
+    - Idempotency
+    - Kubernetes
+    - Saga
+    - TCC
+    - XA
+
+- title: "When AI Agents Meet Enterprise Reality: Workflows, Transactions, and Runtime Controls"
+  description: Explore the workflow, transaction, and runtime controls that help AI agents operate safely across enterprise systems of record.
+  date: 2026-06-23 00:00:00 +0000
+  author_id: pruthvithej-ramesh-kumar
+  external: true
+  url: https://blogs.oracle.com/database/ai-agents-enterprise-reality-workflows-transactions-runtime-controls
+  tags:
+    - Agentic AI
+    - AI Agents
+    - Enterprise AI
+    - Production AI
+    - Oracle MicroTx Workflows
+    - Durable Execution
+    - Durable Workflows
+    - Human Approval
+    - Idempotency
+    - MCP
+    - RAG
+    - Runtime Controls
+    - Saga
+    - Systems of Record
+    - Transaction Coordination
+    - Workflow Orchestration
+    - XA
+    - TCC
+
+- title: Automating Invoice Processing with Oracle MicroTx Workflows
+  description: A practical look at automating invoice processing with Oracle MicroTx Workflows, from AI-assisted tasks through controlled approval and execution.
+  date: 2026-06-23 00:00:00 +0000
+  author_id: brijesh-deo
+  external: true
+  url: https://medium.com/@brijesh.deo/automating-invoice-processing-with-oracle-microtx-workflows-6bdb8cded310
+  tags:
+    - Oracle MicroTx Workflows
+    - Agentic Workflows
+    - AI-Assisted Workflows
+    - Human Approval
+    - Idempotency
+    - Oracle Database
+    - Workflow Orchestration
+
+- title: Oracle MicroTx 26.1 is now generally available
+  description: Discover Oracle MicroTx 26.1, combining durable workflow orchestration and distributed transaction coordination for resilient enterprise applications.
+  date: 2026-06-11 00:00:00 +0000
+  author_id: deepak-goel
+  external: true
+  url: https://blogs.oracle.com/database/oracle-microtx-26-1-is-now-generally-available
+  tags:
+    - Oracle MicroTx Workflows
+    - Durable Workflows
+    - Distributed Transactions
+    - Conductor OSS
+    - Oracle Database
+    - Agentic AI
+    - AI Agents
+    - MCP
+    - RAG
+    - Saga
+    - TCC
+    - XA
+    - Workflow Orchestration
+
+- title: Deploy MicroTx Workflow Server in OKE
+  description: Watch how to deploy the Oracle MicroTx Workflow Server on Oracle Kubernetes Engine.
+  date: 2026-08-11 00:00:00 +0000
+  author_id: shivanshu-singh
+  external: true
+  video: true
+  url: https://www.youtube.com/watch?v=2TyDIQy8F_U
+  tags:
+    - Oracle MicroTx Workflows
+    - OCI
+    - OKE
+    - Kubernetes
+    - Deployment
+    - Workflow Orchestration
+
+- title: Designing and Deploying Agentic Workflows with Distributed Transactions
+  description: Follow this Oracle LiveLabs workshop to design and deploy agentic workflows with Oracle MicroTx distributed transactions.
+  date: 2026-06-20 00:00:00 +0000
+  author_id: oracle-microtx-team
+  external: true
+  url: https://livelabs.oracle.com/ords/r/dbpm/livelabs/view-workshop?wid=4243
+  tags:
+    - Agentic AI
+    - Agentic Workflows
+    - Distributed Transactions
+    - Oracle MicroTx Workflows
+    - Workflow Orchestration
diff --git a/docs/_includes/article-card.html b/docs/_includes/article-card.html
@@ -0,0 +1,21 @@
+{% assign article = include.article %}
+{% assign author = site.data.authors[article.author_id] %}
+<article class="article-card">
+  {% if article.image %}
+  <a class="card-image" href="{% if article.external %}{{ article.url }}{% else %}{{ article.url | relative_url }}{% endif %}" aria-label="Read {{ article.title }}"{% if article.external %} target="_blank" rel="noopener noreferrer"{% endif %}>
+    <img src="{{ article.image | relative_url }}" alt="{{ article.image_alt | default: '' }}">
+  </a>
+  {% endif %}
+  <div class="card-content">
+    <p class="article-date"><time datetime="{{ article.date | date_to_xmlschema }}">{{ article.date | date: "%B %-d, %Y" }}</time></p>
+    {% if article.video %}<span class="content-type content-type--video"><span aria-hidden="true"></span>Video</span>{% endif %}
+    {% if author or article.author %}<p class="card-author">By {{ author.name | default: article.author }}</p>{% endif %}
+    <h2><a href="{% if article.external %}{{ article.url }}{% else %}{{ article.url | relative_url }}{% endif %}"{% if article.external %} target="_blank" rel="noopener noreferrer"{% endif %}>{{ article.title }}</a></h2>
+    <p>{{ article.description }}</p>
+    {% if article.tags %}
+    <ul class="tags" aria-label="Article tags">
+      {% for tag in article.tags %}<li><a href="{{ '/tags/' | relative_url }}#{{ tag | slugify }}">{{ tag }}</a></li>{% endfor %}
+    </ul>
+    {% endif %}
+  </div>
+</article>
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html
@@ -0,0 +1,38 @@
+<!doctype html>
+<html lang="{{ site.lang | default: 'en' }}" data-theme="light">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <script>try { if (localStorage.getItem('microtx-theme') === 'dark') document.documentElement.dataset.theme = 'dark'; } catch (error) {}</script>
+    <link rel="stylesheet" href="{{ '/assets/css/style.css' | relative_url }}">
+    <link rel="stylesheet" href="{{ '/assets/css/rouge.css' | relative_url }}">
+    <meta name="keywords" content="{{ site.seo_keywords | join: ', ' }}">
+    {% feed_meta %}
+    {% seo %}
+  </head>
+  <body>
+    <header class="site-header">
+      <div class="site-shell header-content">
+        <a class="brand" href="{{ '/' | relative_url }}" aria-label="Oracle MicroTx home">
+          <img class="brand-logo brand-logo--light" src="{{ '/assets/images/logo/oracle-microtx-black.png' | relative_url }}" alt="Oracle MicroTx" width="136" height="60">
+          <img class="brand-logo brand-logo--dark" src="{{ '/assets/images/logo/oracle-microtx-white.png' | relative_url }}" alt="" width="136" height="60">
+        </a>
+        <nav aria-label="Primary navigation">
+          <a href="https://www.oracle.com/database/transaction-manager-for-microservices/" target="_blank" rel="noopener noreferrer">Oracle MicroTx</a>
+          <a href="{{ '/' | relative_url }}">Articles</a>
+          <button class="theme-toggle" type="button" aria-pressed="false">Dark theme</button>
+        </nav>
+      </div>
+    </header>
+    <main class="site-shell">{{ content }}</main>
+    <footer class="site-footer">
+      <nav class="site-shell footer-links" aria-label="Footer navigation">
+        <a href="https://docs.oracle.com/en/database/oracle/transaction-manager-for-microservices/26.1/" target="_blank" rel="noopener noreferrer">MicroTx Documentation</a>
+        <a href="https://www.oracle.com/in/legal/copyright/" target="_blank" rel="noopener noreferrer">Copyright</a>
+        <a href="https://github.com/oracle-samples/microtx-samples/issues" target="_blank" rel="noopener noreferrer">GitHub Issues</a>
+      </nav>
+    </footer>
+    <script src="{{ '/assets/js/theme-toggle.js' | relative_url }}"></script>
+    <script src="{{ '/assets/js/article-enhancements.js' | relative_url }}"></script>
+  </body>
+</html>
diff --git a/docs/_layouts/post.html b/docs/_layouts/post.html
@@ -0,0 +1,20 @@
+---
+layout: default
+---
+<article class="post">
+  {% assign author = site.data.authors[page.author_id] %}
+  <header class="post-header">
+    <h1>{{ page.title }}</h1>
+    <p class="post-description">{{ page.description }}</p>
+    <div class="post-meta">
+      {% if author %}<p class="author">By {{ author.name }}{% if author.role %}, {{ author.role }}{% endif %}{% if author.github %} · <a href="{{ author.github }}" target="_blank" rel="noopener noreferrer">GitHub</a>{% endif %}{% if author.linkedin %} · <a href="{{ author.linkedin }}" target="_blank" rel="noopener noreferrer">LinkedIn</a>{% endif %}</p>{% endif %}
+      <p class="article-date"><time datetime="{{ page.date | date_to_xmlschema }}">{{ page.date | date: "%B %-d, %Y" }}</time>{% if page.updated %} · Updated {{ page.updated | date: "%B %-d, %Y" }}{% endif %}</p>
+    </div>
+    {% if page.tags %}<ul class="tags" aria-label="Article tags">{% for tag in page.tags %}<li><a href="{{ '/tags/' | relative_url }}#{{ tag | slugify }}">{{ tag }}</a></li>{% endfor %}</ul>{% endif %}
+  </header>
+  <div class="post-content">{{ content }}</div>
+  <footer class="article-footer">
+    <a href="https://docs.oracle.com/en/database/oracle/transaction-manager-for-microservices/26.1/">Learn more about Oracle MicroTx</a>
+    <a href="https://github.com/oracle-samples/microtx-samples/issues/new?title={{ 'Feedback%3A%20' | append: page.title | uri_escape }}&body={{ 'Feedback%20on%3A%20' | append: page.url | absolute_url | uri_escape }}">Found an issue with this article?</a>
+  </footer>
+</article>
diff --git a/docs/_posts/2026-08-10-deploy-microtx-free-oci-marketplace.md b/docs/_posts/2026-08-10-deploy-microtx-free-oci-marketplace.md
@@ -0,0 +1,53 @@
+---
+title: Deploy Oracle MicroTx Free on OCI with Oracle Cloud Marketplace
+description: Provision a new Oracle Kubernetes Engine cluster and deploy MicroTx Free using the Oracle Cloud Marketplace Terraform stack.
+date: 2026-08-10
+updated: 2026-08-13
+author: BHARATH MC
+author_id: bharath-mc
+tags:
+  - MicroTx
+  - OCI
+  - OKE
+  - Oracle Cloud Marketplace
+  - Terraform
+---
+
+Oracle Cloud Marketplace provides a guided route to deploy Oracle MicroTx Free in Oracle Cloud Infrastructure (OCI). The Marketplace stack uses Terraform to provision the required OCI resources, create a new Oracle Kubernetes Engine (OKE) cluster, and deploy MicroTx to that cluster. It does not deploy to an existing OKE cluster.
+
+## Before you begin
+
+Prepare an OCI account with permissions to provision the required OCI resources, including a new OKE cluster and related networking. Complete the <a href="https://docs.oracle.com/en/database/oracle/transaction-manager-for-microservices/26.1/tmmmg/prerequisites.html" target="_blank" rel="noopener noreferrer">prerequisites</a> and review the <a href="https://docs.oracle.com/en/database/oracle/transaction-manager-for-microservices/26.1/tmmmg/minimum-resource-requirements.html" target="_blank" rel="noopener noreferrer">minimum resource requirements</a> for the complete Terraform stack, including OKE worker nodes, the database, load balancer, file storage, and jump host.
+
+## Deploy from Marketplace
+
+1. Search Oracle Cloud Marketplace for **Oracle MicroTx**, then select <strong><a href="https://marketplace.oracle.com/listings/oracle-microtx-free/ocid1.mktpublisting.oc1.iad.amaaaaaahwdhddqa5wdzog7vbmg2yo2hflgbbxl4ffrnhhgqs32t34nmy2ya" target="_blank" rel="noopener noreferrer">Oracle MicroTx Free</a></strong>.
+2. Select **Get App**, then launch the supplied stack in OCI Resource Manager.
+3. Provide the stack inputs described below.
+4. Review the execution plan and apply the stack.
+5. Monitor the **Apply Job**. When it completes, use the stack outputs and deployment instructions to access MicroTx.
+
+## Stack inputs
+
+The Marketplace form groups the main inputs into the following sections. For field-level guidance and the complete provisioning procedure, use the <a href="https://docs.oracle.com/en/database/oracle/transaction-manager-for-microservices/26.1/tmmmg/provision-microtx-oracle-cloud-marketplace.html" target="_blank" rel="noopener noreferrer">official Oracle deployment guide</a>.
+
+- **MicroTx Configurations:** Select the MicroTx version to install and enter a deployment name, which prefixes generated OCI resources. Enter a domain name for the MicroTx HTTPS hostname; the stack generates `<Deployment Name>.<Domain Name>`, such as `microtx-demo.example.com`, and uses a self-signed certificate to secure TLS access to the endpoint.
+- **Database Configuration:** Connect MicroTx to your own Oracle Database, or have the stack provision an Oracle Autonomous AI Database in the FREE, DEVELOPER, or PAID edition.
+- **Workflow Server Secret:** Upload the `encryption.key` file used to encrypt and store sensitive Workflow Server data. Create the key by following the <a href="https://docs.oracle.com/en/database/oracle/transaction-manager-for-microservices/26.1/tmmmg/prerequisites.html" target="_blank" rel="noopener noreferrer">encryption-key prerequisites</a>.
+- **Kubernetes Cluster Configurations:** Configure the worker node-pool name, autoscaling and its minimum and maximum worker-node counts, node instance shape, OCPUs, and memory.
+
+## Access MicroTx
+
+After the **Apply Job** completes, open its output values and complete the following steps:
+
+1. Copy the `hosts_entry` output, for example `129.xx.xx.xx microtx-demo.example.com`, to your local `/etc/hosts` file.
+2. Open the `launch_microtx` output URL, for example `https://microtx-demo.example.com/consoleui/`, to access the MicroTx Console UI.
+3. The stack uses a self-signed TLS certificate, so your browser might display a security warning. Accept the warning to continue to the Console UI.
+
+## Next steps
+
+Explore the <a href="https://github.com/oracle-samples/microtx-samples/tree/main/workflow" target="_blank" rel="noopener noreferrer">MicroTx Workflow samples</a> for workflow-based orchestration. For distributed transactions, use the <a href="https://github.com/oracle-samples/microtx-samples/tree/main/xa" target="_blank" rel="noopener noreferrer">XA</a>, <a href="https://github.com/oracle-samples/microtx-samples/tree/main/lra" target="_blank" rel="noopener noreferrer">LRA</a>, or <a href="https://github.com/oracle-samples/microtx-samples/tree/main/tcc" target="_blank" rel="noopener noreferrer">TCC</a> samples. Select the pattern that fits the consistency and compensation needs of your services. For the complete Marketplace procedure and every stack option, see the <a href="https://docs.oracle.com/en/database/oracle/transaction-manager-for-microservices/26.1/tmmmg/provision-microtx-oracle-cloud-marketplace.html" target="_blank" rel="noopener noreferrer">official Oracle deployment guide</a>.
+
+### Also explore
+
+The <a href="https://github.com/oracle-samples/microtx-samples/tree/main/docs/quickstart" target="_blank" rel="noopener noreferrer">quick-start documentation</a> covers deployment paths for a local Minikube environment and an OKE cluster.
diff --git a/docs/assets/css/rouge.css b/docs/assets/css/rouge.css
@@ -0,0 +1,7 @@
+.highlight .c, .highlight .c1, .highlight .cm { color: #7f8c8d; }
+.highlight .k, .highlight .kd, .highlight .kn, .highlight .kp, .highlight .kr { color: #d35400; }
+.highlight .s, .highlight .s1, .highlight .s2, .highlight .sa, .highlight .sb { color: #2e7d32; }
+.highlight .m, .highlight .mi, .highlight .mf, .highlight .mh { color: #6a1b9a; }
+.highlight .nf, .highlight .nc, .highlight .nt { color: #1565c0; }
+.highlight .o, .highlight .p { color: #d4dbe3; }
+.highlight .na { color: #00838f; }