From 7afdf11456ff3655a7d5d00c3b8ad4b82e57db45 Mon Sep 17 00:00:00 2001
From: Nabeel Al-Saber <21160931+nalsaber@users.noreply.github.com>
Date: Fri, 28 Jun 2019 07:03:42 -0700
Subject: [PATCH] Add Oracle scenario guide (#58443)

* Create and update docs/docsite/rst/scenario_guides/guide_oracle.rst
---
 .../rst/scenario_guides/cloud_guides.rst      |   1 +
 .../rst/scenario_guides/guide_oracle.rst      | 103 ++++++++++++++++++
 docs/docsite/rst/scenario_guides/guides.rst   |   1 +
 3 files changed, 105 insertions(+)
 create mode 100644 docs/docsite/rst/scenario_guides/guide_oracle.rst

diff --git a/docs/docsite/rst/scenario_guides/cloud_guides.rst b/docs/docsite/rst/scenario_guides/cloud_guides.rst
index a2e21b43159..d430bddae95 100644
--- a/docs/docsite/rst/scenario_guides/cloud_guides.rst
+++ b/docs/docsite/rst/scenario_guides/cloud_guides.rst
@@ -15,6 +15,7 @@ The guides in this section cover using Ansible with a range of public cloud plat
    guide_gce
    guide_azure
    guide_online
+   guide_oracle
    guide_packet
    guide_rax
    guide_scaleway
diff --git a/docs/docsite/rst/scenario_guides/guide_oracle.rst b/docs/docsite/rst/scenario_guides/guide_oracle.rst
new file mode 100644
index 00000000000..170ea9031ba
--- /dev/null
+++ b/docs/docsite/rst/scenario_guides/guide_oracle.rst
@@ -0,0 +1,103 @@
+===================================
+Oracle Cloud Infrastructure Guide
+===================================
+
+************
+Introduction
+************
+
+Oracle provides a number of Ansible modules to interact with Oracle Cloud Infrastructure (OCI). In this guide, we will explain how you can use these modules to orchestrate, provision and configure your infrastructure on OCI. 
+
+************
+Requirements
+************
+To use the OCI Ansible modules, you must have the following prerequisites on your control node, the computer from which Ansible playbooks are executed.
+
+1. `An Oracle Cloud Infrastructure account. <https://cloud.oracle.com/en_US/tryit>`_
+
+2. A user created in that account, in a security group with a policy that grants the necessary permissions for working with resources in those compartments. For guidance, see `How Policies Work <https://docs.cloud.oracle.com/iaas/Content/Identity/Concepts/policies.htm>`_.
+
+3. The necessary credentials and OCID information.
+
+************
+Installation
+************ 
+1. Install the Oracle Cloud Infrastructure Python SDK (`detailed installation instructions <https://oracle-cloud-infrastructure-python-sdk.readthedocs.io/en/latest/installation.html>`_):
+
+.. code-block:: bash
+
+        pip install oci
+
+2.  Install the Ansible OCI Modules in one of two ways:
+
+a.	From Galaxy: 
+
+.. code-block:: bash
+
+ ansible-galaxy install oracle.oci_ansible_modules
+
+b.	From GitHub:
+
+.. code-block:: bash
+
+     $ git clone https://github.com/oracle/oci-ansible-modules.git
+
+.. code-block:: bash
+
+    $ cd oci-ansible-modules
+
+
+Run one of the following commands:
+
+- If Ansible is installed only for your user: 
+
+.. code-block:: bash
+
+    $ ./install.py
+
+- If Ansible is installed as root: 
+
+.. code-block:: bash
+
+    $ sudo ./install.py
+
+*************
+Configuration
+*************
+
+When creating and configuring Oracle Cloud Infrastructure resources, Ansible modules use the authentication information outlined `here <https://docs.cloud.oracle.com/iaas/Content/API/Concepts/sdkconfig.htm>`_.
+.
+ 
+********
+Examples
+********
+Launch a compute instance
+=========================
+This `sample launch playbook <https://github.com/oracle/oci-ansible-modules/tree/master/samples/compute/launch_compute_instance>`_
+launches a public Compute instance and then accesses the instance from an Ansible module over an SSH connection. The sample illustrates how to:
+
+- Generate a temporary, host-specific SSH key pair.
+- Specify the public key from the key pair for connecting to the instance, and then launch the instance.
+- Connect to the newly launched instance using SSH.
+
+Create and manage Autonomous Data Warehouses
+============================================
+This `sample warehouse playbook <https://github.com/oracle/oci-ansible-modules/tree/master/samples/database/autonomous_data_warehouse>`_ creates an Autonomous Data Warehouse and manage its lifecycle. The sample shows how to:
+
+- Set up an Autonomous Data Warehouse.
+- List all of the Autonomous Data Warehouse instances available in a compartment, filtered by the display name.
+- Get the "facts" for a specified Autonomous Data Warehouse.
+- Stop and start an Autonomous Data Warehouse instance.
+- Delete an Autonomous Data Warehouse instance.
+
+Create and manage Autonomous Transaction Processing
+===================================================
+This `sample playbook <https://github.com/oracle/oci-ansible-modules/tree/master/samples/database/autonomous_database>`_
+creates an Autonomous Transaction Processing database and manage its lifecycle. The sample shows how to:
+
+- Set up an Autonomous Transaction Processing database instance.
+- List all of the Autonomous Transaction Processing instances in a compartment, filtered by the display name.
+- Get the "facts" for a specified Autonomous Transaction Processing instance.
+- Delete an Autonomous Transaction Processing database instance.
+
+You can find more examples here: `Sample Ansible Playbooks <https://docs.cloud.oracle.com/iaas/Content/API/SDKDocs/ansiblesamples.htm>`_.
diff --git a/docs/docsite/rst/scenario_guides/guides.rst b/docs/docsite/rst/scenario_guides/guides.rst
index 65a40b98c75..2ff65bbc73e 100644
--- a/docs/docsite/rst/scenario_guides/guides.rst
+++ b/docs/docsite/rst/scenario_guides/guides.rst
@@ -19,6 +19,7 @@ platforms, products, and technologies. They explore particular use cases in grea
    guide_gce
    guide_azure
    guide_online
+   guide_oracle
    guide_packet
    guide_rax
    guide_scaleway