|
| 1 | +# Oracle Database@Google Cloud: Create an Autonomous Database |
| 2 | +There are different ways that you can deploy a new Oracle Autonomous Database: |
| 3 | +* [Using the Google Cloud Portal](https://docs.oracle.com/en-us/iaas/ogadb/ogadb-provisioning-autonomous-database.html) |
| 4 | +* [Using Terraform scripts](https://github.com/oci-landing-zones/terraform-oci-multicloud-azure) |
| 5 | +* Using the Google Command Line Interace (gcloud CLI) |
| 6 | + |
| 7 | + |
| 8 | +The steps below show how to create an Autonomous Database using the gcloud CLI. |
| 9 | + |
| 10 | +## Prerequisites: |
| 11 | +* [Install the gcloud CLI](https://cloud.google.com/sdk/docs/install) |
| 12 | +* [Onboard Oracle Database@Google Cloud](https://docs.oracle.com/en-us/iaas/Content/database-at-gcp/oagcp-onboard.htm#oagcp_onboard). Onboarding includes subscribing to the service using a Pay as You Go or private offer, setting up permissions, and more. |
| 13 | + |
| 14 | +## Deploy your Autonomous Database and your infrastructure |
| 15 | +The gcloud CLI scripts will deploy the following infrastructure: |
| 16 | +* A VPC Network with a client subnet |
| 17 | +* An Oracle Autonomous Database. It is deployed to a private subnet on that VPC Network. That private subnet is managed by Oracle Database@Google Cloud. |
| 18 | +* A Windows-based Virtual Machine is deployed to the client subnet. You can RDP to that VM to develop your apps and access Autonomous Database. |
| 19 | +* A Cloud Storage bucket with sample data |
| 20 | +* Sample code will use Google Gemini. Ensure the API is enabled. |
| 21 | + |
| 22 | + |
| 23 | + |
| 24 | + |
| 25 | +**Note:** Gemini is used by the samples - but the scripts do not set up access to the resource. See the [Generative AI on Vertex Quickstart](https://cloud.google.com/vertex-ai/generative-ai/docs/start/quickstarts/quickstart-multimodal?authuser=1) |
| 26 | + |
| 27 | +You can run the scripts independently or run `create-all-resources.sh`. Simply update the [`config`](#configuration-file) prior to running the scripts: |
| 28 | + |
| 29 | +|Script|Description| |
| 30 | +|----|---| |
| 31 | +|[create-network.sh](create-network.sh)|Creates a VPC Network and subnet with required firewall rules. ADB is accessed thru a private endpoint on this network. The VM is deployed to this network and can be used to work with ADB.| |
| 32 | +|[create-adb.sh](create-adb.sh)|Create an Autonomous Database| |
| 33 | +|[create-compute-vm.sh](create-compute-vm.sh)|Create a VM in that VPC. By default, a Windows VM is created and can be accessed via RDP. After running this script, you can set up the password by running: <br>`source config`<br>`gcloud compute reset-windows-password $VM_NAME --zone=$REGION-a`| |
| 34 | +|[create-all-resources.sh](create-all-resources.sh)|Creates your network, ADB, VM and Cloud Storage bucket.| |
| 35 | +|[create-data-lake-storage.sh](create-data-lake-storage.sh)|Creates a bucket on Cloud Storage and uploads sample data into that bucket| |
| 36 | +|[delete-all-resources.sh](delete-all-resources.sh)|Deletes your resource group, network, ADB and VM| |
| 37 | +|[show-adb-info.sh](show-adb-info.sh)|Shows information about your ADB - including you JDBC connection details to the HIGH service| |
| 38 | +|[show-data-lake-storage-info.sh](show-data-lake-storage-info.sh)|Shows information about your data lake storage - including the storage endpoint URL| |
| 39 | + |
| 40 | +### Configuration file |
| 41 | +The gcloud CLI deployment scripts rely on settings found in the config file. These resources **will be created** by the scripts. Update the config file prior to running any of the scripts. |
| 42 | + |
| 43 | +>**IMPORTANT:** This file will contain a password that is used to connect to Autonomous Database and the virtual machine. Set the file's permissions so that only the file's owner can view its contents: |
| 44 | +```bash |
| 45 | +chmod 600 config |
| 46 | +``` |
| 47 | + |
| 48 | +|Setting|Description|Example| |
| 49 | +|----|----|----| |
| 50 | +|REGION|Region where resources will be deployed. [See documentation](https://docs.oracle.com/en-us/iaas/Content/database-at-gcp/oagcp-regions.htm) for region availability|"us-east4"| |
| 51 | +|PROJECT|Target Google Cloud project for new resources|"development"| |
| 52 | +|USER_PASSWORD|The password for the Autonomous Database admin user|"watchS0meMovies#"| |
| 53 | +|ADB_NAME|Autonomous Database name. This name must be unique within a region location|"quickstart"| |
| 54 | +|SUBNET_DB_IP_RANGE|IP address range used for ADB. It can not overlap with the client subnet range. It can overlap with other ADB instances.|"192.168.11.0/24"| |
| 55 | +|VPC_NETWORK_NAME|Name of the VPC Network|"dev-network"| |
| 56 | +|VNET_PREFIX|CIDR range for the virtual network|"192.168.0.0/16"| |
| 57 | +|SUBNET_CLIENT_NAME|Name of the client subnet where the VM is deployed|"dev-sn-client"| |
| 58 | +|SUBNET_CLIENT_IP_RANGE|CIDR range for the client subnet|"192.168.10.0/24"| |
| 59 | +|VM_NAME|Name of the virtual machine|"dev-vm-client"| |
| 60 | +|VM_IMAGE_FAMILY|The image deployed to the VM |"windows-2022"| |
| 61 | +|VM_MACHINE_TYPE|The type of VM deployed|"e2-standard-4"| |
| 62 | +|BUCKET_NAME|The name of the cloud storage bucket where sample files will be uploaded.|"adb-sample-quickstart"| |
| 63 | + |
| 64 | + |
| 65 | +### Using the scripts |
| 66 | +Make sure that you have enabled APIs for your project. [See the documentation](https://cloud.google.com/endpoints/docs/openapi/enable-api) for details. |
| 67 | + |
| 68 | +Log into Google Cloud from the CLI: |
| 69 | +```bash |
| 70 | +gcloud auth login |
| 71 | +``` |
| 72 | + |
| 73 | +Update the config file |
| 74 | +Then, run your scripts. The following will deploy a complete environment, but you can also install independent components. Just make sure you install dependencies (e.g. a VCN prior to Autonomous Database): |
| 75 | + |
| 76 | +Creating all of the resources will take approximately 15-20 minutes. |
| 77 | + |
| 78 | +```bash |
| 79 | +./create-all-resources.sh |
| 80 | +``` |
| 81 | + |
| 82 | +Check for errors after running the script. For example, VM availability can impact the success of creating the resource. If there is an issue, simply rerun the script that creates the resource (note: you may need to update the config file). |
| 83 | + |
| 84 | +## What's next |
| 85 | +Connect to your Autonomous Database! |
| 86 | +* [Learn about connectivity options](https://docs.oracle.com/en/cloud/paas/autonomous-database/serverless/adbsb/connect-preparing.html) |
| 87 | +* Use these great VS Code extensions that help you develop and debug your database apps: |
| 88 | + * SQL Developer for VS Code ([Learn More](https://www.oracle.com/database/sqldeveloper/vscode/) | [Marketplace](https://marketplace.visualstudio.com/items?itemName=Oracle.sql-developer)) |
| 89 | + * Oracle Developer Tools for VS Code ([Learn More](https://docs.oracle.com/en/database/oracle/developer-tools-for-vscode/getting-started/gettingstarted.html) | [Marketplace](https://marketplace.visualstudio.com/items?itemName=Oracle.oracledevtools)) |
| 90 | +* [Use the sample scripts](../../sql/README.md) to learn how to use different features - like Select AI, data lake integration, JSON, and more. |
| 91 | + |
| 92 | + |
| 93 | +#### JDBC Example: |
| 94 | +JDBC is a common way to connect to Autonomous Database. For example, you can use the **Custom JDBC URL** in the VS Code SQL Developer Extension: |
| 95 | +  |
| 96 | + |
| 97 | +Notice the `jdbc:oracle:thin:@` prefix followed by a connection string. You can find the connection string in different ways. |
| 98 | + |
| 99 | +1. Go to your Autonomous Database blade in the Azure Portal and go to **Settings -> Connections**: |
| 100 | +  |
| 101 | +2. Use the Azure cli script [`show-adb-info.sh`](./show-adb-info.sh). That script will return information about your Autonomous Database, including connection details. |
| 102 | + |
| 103 | +<hr> |
| 104 | +Copyright (c) 2024 Oracle and/or its affiliates.<br> |
| 105 | +Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/ |
0 commit comments