feat: New Oracle Database@Azure Section (#690)

gkayali · kpoineal · web-flow · commit f5f94d95cfd3 · 2025-05-05T20:04:51.000-06:00
Co-authored-by: Kyle Poineal &lt;38540295+kpoineal@users.noreply.github.com&gt;
diff --git a/.github/scripts/schemas/aprl-schema.yaml b/.github/scripts/schemas/aprl-schema.yaml
@@ -18,7 +18,7 @@ recommendation:
   potentialBenefits: str(max=60)
   pgVerified: bool()
   automationAvailable: bool()
-  tags: list(enum('AI-GPT-RAG', 'AVD', 'AVS', 'HPC', 'SAP','WAF'))
+  tags: list(enum('AI-GPT-RAG', 'AVD', 'AVS', 'HPC', 'SAP','WAF','ORACLE'))
   learnMoreLink: list(include('linkItem'), required=False, max=1)
 
 linkItem:
diff --git a/azure-specialized-workloads/oracle/_index.md b/azure-specialized-workloads/oracle/_index.md
@@ -0,0 +1,18 @@
+---
+title: "Oracle Database@Azure"
+geekdocCollapseSection: true
+geekdocHidden: false
+---
+
+## Relevant Azure Resource Recommendations
+
+| Recommendation                                                                                   | Provider Namespace |  Resource Type  |
+| :----------------------------------------------------------------------------------------------- | :----------------: | :-------------: |
+| [Ensure ODAA infrastructure is in Available state under normal operations](../../../Azure-Proactive-Resiliency-Library-v2/azure-resources/Oracledatabase/cloudexadatainfrastructures/#) |       Oracledatabase        |  cloudexadatainfrastructures  |
+| [Ensure ODAA clusters are in Available state under normal operations](../../../Azure-Proactive-Resiliency-Library-v2/azure-resources/Oracledatabase/cloudvmclusters/#) |      Oracledatabase       | cloudvmclusters |
+
+<br>
+
+## General Workload Guidance
+
+{{< azure-specialized-workloads-recommendationlist name="azure-specialized-workloads-recommendationlist" >}}
diff --git a/azure-specialized-workloads/oracle/kql/02bfe908-d958-451a-a603-bef8277ae56a.kql b/azure-specialized-workloads/oracle/kql/02bfe908-d958-451a-a603-bef8277ae56a.kql
@@ -0,0 +1 @@
+// cannot-be-validated-with-arg
diff --git a/azure-specialized-workloads/oracle/kql/0583239a-dfb5-44d4-94db-804bfc8e3bd1.kql b/azure-specialized-workloads/oracle/kql/0583239a-dfb5-44d4-94db-804bfc8e3bd1.kql
@@ -0,0 +1 @@
+// cannot-be-validated-with-arg
diff --git a/azure-specialized-workloads/oracle/kql/1bfdf86c-f501-4ad9-99a7-b29b736f34dc.kql b/azure-specialized-workloads/oracle/kql/1bfdf86c-f501-4ad9-99a7-b29b736f34dc.kql
@@ -0,0 +1 @@
+// cannot-be-validated-with-arg
diff --git a/azure-specialized-workloads/oracle/kql/2322a597-a6af-4c3e-a1b1-d1b1ddead508.kql b/azure-specialized-workloads/oracle/kql/2322a597-a6af-4c3e-a1b1-d1b1ddead508.kql
@@ -0,0 +1 @@
+// cannot-be-validated-with-arg
diff --git a/azure-specialized-workloads/oracle/kql/5d870898-97d7-437d-9ea9-d8ccced7e6fe.kql b/azure-specialized-workloads/oracle/kql/5d870898-97d7-437d-9ea9-d8ccced7e6fe.kql
@@ -0,0 +1 @@
+// cannot-be-validated-with-arg
diff --git a/azure-specialized-workloads/oracle/kql/768a5b06-41d4-4f10-b544-fbd2f6999af4.kql b/azure-specialized-workloads/oracle/kql/768a5b06-41d4-4f10-b544-fbd2f6999af4.kql
@@ -0,0 +1 @@
+// cannot-be-validated-with-arg
diff --git a/azure-specialized-workloads/oracle/kql/76c9136c-642d-4ea3-a4f5-655f28d2ee07.kql b/azure-specialized-workloads/oracle/kql/76c9136c-642d-4ea3-a4f5-655f28d2ee07.kql
@@ -0,0 +1 @@
+// under-development
diff --git a/azure-specialized-workloads/oracle/kql/a64ea6f4-8c6b-4b76-b152-4e862d19264d.kql b/azure-specialized-workloads/oracle/kql/a64ea6f4-8c6b-4b76-b152-4e862d19264d.kql
@@ -0,0 +1 @@
+// cannot-be-validated-with-arg
diff --git a/azure-specialized-workloads/oracle/kql/bbe4014f-c49d-475d-9c48-76cb3c190483.kql b/azure-specialized-workloads/oracle/kql/bbe4014f-c49d-475d-9c48-76cb3c190483.kql
@@ -0,0 +1 @@
+// cannot-be-validated-with-arg
diff --git a/azure-specialized-workloads/oracle/kql/ccf0fece-27c7-4163-98ce-a1dd982d7f79.kql b/azure-specialized-workloads/oracle/kql/ccf0fece-27c7-4163-98ce-a1dd982d7f79.kql
@@ -0,0 +1 @@
+// cannot-be-validated-with-arg
diff --git a/azure-specialized-workloads/oracle/kql/dfeb9c7a-7dae-4751-9625-b23a7160a3e1.kql b/azure-specialized-workloads/oracle/kql/dfeb9c7a-7dae-4751-9625-b23a7160a3e1.kql
@@ -0,0 +1 @@
+// cannot-be-validated-with-arg
diff --git a/azure-specialized-workloads/oracle/kql/e2750bd4-d12c-409a-bb56-49238d9a8013.kql b/azure-specialized-workloads/oracle/kql/e2750bd4-d12c-409a-bb56-49238d9a8013.kql
@@ -0,0 +1 @@
+// cannot-be-validated-with-arg
diff --git a/azure-specialized-workloads/oracle/recommendations.yaml b/azure-specialized-workloads/oracle/recommendations.yaml
@@ -0,0 +1,146 @@
+- description: Implement Oracle Data Guard replication across availability zones
+  aprlGuid: ccf0fece-27c7-4163-98ce-a1dd982d7f79
+  recommendationTypeId: null
+  recommendationControl: BusinessContinuity
+  recommendationImpact: High
+  recommendationResourceType: Microsoft.Subscription/subscriptions
+  recommendationMetadataState: Active
+  longDescription:
+    Oracle Database@Azure follows a Silver-level reference architecture that provides HA by default however it is vulnerable to AZ failures.
+    Gold-level adds Data Guard replication across AZs via Automated DG or manual setup.
+    Use SYNC for zero data loss or ASYNC when performance is constrained.
+  potentialBenefits: Ensure business continuity in case of zonal failure.
+  pgVerified: false
+  automationAvailable: no
+  tags: [ORACLE]
+  learnMoreLink:
+    - name: Business continuity and disaster recovery considerations for Oracle Database@Azure
+      url: "https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/scenarios/oracle-iaas/oracle-disaster-recovery-oracle-database-azure"
+
+- description: Implement a regional replication strategy for Oracle to meet your workload requirements
+  aprlGuid: dfeb9c7a-7dae-4751-9625-b23a7160a3e1
+  recommendationTypeId: null
+  recommendationControl: DisasterRecovery
+  recommendationImpact: High
+  recommendationResourceType: Microsoft.Subscription/subscriptions
+  recommendationMetadataState: Active
+  longDescription:
+    Gold-level reference architecture with Oracle Database@Azure is recommended, meaning that database changes will be replicated via Data Guard (ASYNC replication) to a secondary Oracle Database@Azure instance in a different region.
+  potentialBenefits: The cloud MAA architecture achieves data protection and DR.
+  pgVerified: false
+  automationAvailable: no
+  tags: [ORACLE]
+  learnMoreLink:
+    - name: Business continuity and disaster recovery considerations for Oracle Database@Azure
+      url: "https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/scenarios/oracle-iaas/oracle-disaster-recovery-oracle-database-azure"
+
+
+- description: Implement Autonomous Recovery Service in Azure for ODAA backup strategy
+  aprlGuid: 0583239a-dfb5-44d4-94db-804bfc8e3bd1
+  recommendationTypeId: null
+  recommendationControl: DisasterRecovery
+  recommendationImpact: High
+  recommendationResourceType: Microsoft.Subscription/subscriptions
+  recommendationMetadataState: Active
+  longDescription: |
+    Enable OCI-managed backup to Autonomous Recovery Service in Azure for data protection.
+    ARS provides automated, policy-based backups with continuous validation.
+  potentialBenefits: Provide workload data protection.
+  pgVerified: false
+  automationAvailable: no
+  tags: [ORACLE]
+  learnMoreLink:
+    - name: Business continuity and disaster recovery considerations for Oracle Database@Azure
+      url: "https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/scenarios/oracle-iaas/oracle-disaster-recovery-oracle-database-azure"
+
+
+- description: Monitor critical Oracle Database metrics with defined thresholds and scale accordingly
+  aprlGuid: 2322a597-a6af-4c3e-a1b1-d1b1ddead508
+  recommendationTypeId: null
+  recommendationControl: Scalability
+  recommendationImpact: Medium
+  recommendationResourceType: Microsoft.Subscription/subscriptions
+  recommendationMetadataState: Active
+  longDescription: |
+    Monitor database metrics such as CPU utilization and memory usage with Azure Monitor, setting alerts for scaling decisions.
+    Auto-scaling isn't available on Oracle Exadata Database@Azure.
+    If needed, scale OCPUs on the VM cluster, if Exa infrastructure capacity allows.
+  potentialBenefits: Meet workload scalability requirements.
+  pgVerified: false
+  automationAvailable: no
+  tags: [ORACLE]
+  learnMoreLink:
+    - name: Learn about Manage and monitor Oracle Database@Azure
+      url: "https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/scenarios/oracle-iaas/oracle-manage-monitor-oracle-database-azure"
+
+
+- description: Plan and implement IP addressing strategy to meet current and future requirements
+  aprlGuid: 1bfdf86c-f501-4ad9-99a7-b29b736f34dc
+  recommendationTypeId: null
+  recommendationControl: OtherBestPractices
+  recommendationImpact: Medium
+  recommendationResourceType: Microsoft.Subscription/subscriptions
+  recommendationMetadataState: Active
+  longDescription: |
+    Design an IP addressing scheme considering current and future Oracle workload needs to prevent conflicts and ensure availability.
+    Primary, standby, client, and backup subnets should have non-overlapping CIDR ranges for reliable connectivity.
+  potentialBenefits: Avoid conflicts in IP addressing.
+  pgVerified: false
+  automationAvailable: no
+  tags: [ORACLE]
+  learnMoreLink:
+    - name: Capacity planning for Oracle Database@Azure
+      url: "https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/scenarios/oracle-iaas/oracle-capacity-planning-oracle-database-azure"
+
+
+- description: Deploy Data Guard observer in different Availability zones for high availability
+  aprlGuid: 768a5b06-41d4-4f10-b544-fbd2f6999af4
+  recommendationTypeId: null
+  recommendationControl: BusinessContinuity
+  recommendationImpact: High
+  recommendationResourceType: Microsoft.Subscription/subscriptions
+  recommendationMetadataState: Active
+  longDescription: |
+    Deploy Data Guard observer nodes in different AZs and make sure that an observer node will remain available if anything happens to the Production deployment.
+  potentialBenefits: Data Guard observer automates database failover.
+  pgVerified: false
+  automationAvailable: no
+  tags: [ORACLE]
+  learnMoreLink:
+    - name: Business continuity and disaster recovery considerations for Oracle Database@Azure
+      url: "https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/scenarios/oracle-iaas/oracle-disaster-recovery-oracle-database-azure"
+
+- description: Set up Oracle Key Vault in a highly available cluster for customer-managed encryption keys.
+  aprlGuid: bbe4014f-c49d-475d-9c48-76cb3c190483
+  recommendationTypeId: null
+  recommendationControl: HighAvailability
+  recommendationImpact: High
+  recommendationResourceType: Microsoft.Subscription/subscriptions
+  recommendationMetadataState: Active
+  longDescription: |
+    Provide redundancy for VMs used as OKV, note that this is only relevant if customer is using own keys and only if OCI vault is not used. A minimum 4-node OKV cluster deployment is recommended across two AZs or regions, aligned with the BCDR architecture.
+  potentialBenefits: Protect access to keys in case of VM or AZ/region failure.
+  pgVerified: false
+  automationAvailable: no
+  tags: [ORACLE]
+  learnMoreLink:
+    - name: Security guidelines for Oracle Database@Azure
+      url: "https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/scenarios/oracle-iaas/oracle-security-overview-odaa"
+
+- description: Ensure Oracle Database@Azure Infrastructure is updated in a rolling manner.
+  aprlGuid: 02bfe908-d958-451a-a603-bef8277ae56a
+  recommendationTypeId: null
+  recommendationControl: OtherBestPractices
+  recommendationImpact: High
+  recommendationResourceType: Microsoft.Subscription/subscriptions
+  recommendationMetadataState: Active
+  longDescription: |
+    Non-rolling maintenance incurs a downtime.
+    Automatic infrastructure maintenance occurs quarterly, with Oracle notifying you of the date and time weeks in advance. You can modify the scheduled date and time before maintenance starts.
+  potentialBenefits: Keep Oracle workloads up-to-date.
+  pgVerified: false
+  automationAvailable: no
+  tags: [ORACLE]
+  learnMoreLink:
+    - name: Configure Oracle-Managed Infrastructure Maintenance
+      url: "https://docs.oracle.com/en-us/iaas/exadatacloud/doc/exa-conf-oracle-man-infra.html"
