Oracle Cloud Infrastructure

https://docs.oracle.com/en-us/iaas/Content/
Admin
Oracle Cloud Infrastructure (OCI) is a comprehensive cloud computing platform providing services for...
Tokens:11,082,988
Snippets:82,935
Trust Score:9.7
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Start agent with example volume path

Source: https://docs.oracle.com/en-us/iaas/Content/access-governance/agent-administration.htm

Example of starting the agent with a sample persistent volume path.

```bash
curl https://raw.githubusercontent.com/oracle/docker-images/main/OracleIdentityGovernance/samples/scripts/agentManagement.sh -o agentManagement.sh ; sh agentManagement.sh \
--volume /access-governance/agent-management/volume \
--start

```

--------------------------------

### Example: Get Base64-encoded CA Certificate with CLI

Source: https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengcloudinitforselfmanagednodes.htm

Example of the CLI command to obtain the base64-encoded CA certificate, using a sample cluster OCID and region. The output is a long alphanumeric string starting with `LS0t`.

```bash
oci ce cluster create-kubeconfig --cluster-id ocid1.cluster.oc1.phx.aaaaaaaa______ivq --region us-phoenix-1 --file - | grep -oE "LS0t.*"
```

--------------------------------

### Initialize, install dependencies, and run the Go consumer example

Source: https://docs.oracle.com/en-us/iaas/Content/Streaming/Tasks/streaming-quickstart-oci-sdk-for-go.htm

Run these commands in order from the wd directory to initialize the Go module, install the OCI SDK for Go and Streaming, and run the consumer example. The first command creates the go.mod file, the second installs dependencies, and the third executes the program.

```bash
go mod init oss_consumer_example/v0
```

```bash
go mod tidy
```

```bash
go run Consumer.go
```

--------------------------------

### Install Spark and Dependencies

Source: https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/hdfsconnectorspark.htm

Install Spark and its dependencies (Java 1.8, Scala 2.12.4) on Oracle Linux 7.4, then start a Spark master. Requires sudo access and wget. The example installs Spark into the current user's home directory, which is not recommended for production.

```bash
# We'll use wget to download some of the artifacts that need to be installed
sudo yum install wget
 
# First install Java
sudo yum install java-1.8.0-openjdk.x86_64
export JAVA_HOME=/usr/lib/jvm/jre-1.8.0-openjdk
# Should be something like: OpenJDK Runtime Environment (build 1.8.0_161-b14)
java -version
 
# Then install Scala
wget https://downloads.lightbend.com/scala/2.12.4/scala-2.12.4.rpm
sudo yum install scala-2.12.4.rpm
# Should be something like: Scala code runner version 2.12.4 -- Copyright 2002-2017, LAMP/EPFL and Lightbend, Inc.
scala -version
 
# Then download Spark
wget https://archive.apache.org/dist/spark/spark-2.2.1/spark-2.2.1-bin-hadoop2.7.tgz
tar xvf spark-2.2.1-bin-hadoop2.7.tgz
export SPARK_HOME=$HOME/spark-2.2.1-bin-hadoop2.7
export PATH=$PATH:$SPARK_HOME/bin
 
# Start a Spark master
cd $SPARK_HOME
./sbin/start-master.sh
```

--------------------------------

### Custom Dockerfile with Oracle Instant Client

Source: https://docs.oracle.com/en-us/iaas/Content/Functions/Tasks/functionsusingcustomdockerfiles.htm

Example of a custom Dockerfile that installs Oracle Instant Client from an oraclelinux:7-slim base image. This is a starting point for a custom Dockerfile.

```dockerfile
FROM oraclelinux:7-slim

RUN  yum -y install oracle-release-el7 oracle-nodejs-release-el7 && \
     yum-config-manager --disable ol7_developer_EPEL && \
     yum -y install oracle-instantclient19.3-basiclite nodejs && \
     rm -rf /var/cache/yum

WORKDIR /function
ADD . /function/
RUN npm install

CMD exec node func.js

```

--------------------------------

### Run Java QuickStart with Maven

Source: https://docs.oracle.com/en-us/iaas/Content/generative-ai-agents/adk/api-reference/quickstart.htm

Terminal command to run the Java QuickStart example. Must be executed from the root of the project where pom.xml is located. Uses Maven exec plugin with main class demos.QuickStart and working directory java/examples.

```bash
mvn compile exec:java \
  -Dexec.mainClass="demos.QuickStart" \
  -Dexec.workingdir=java/examples

```

--------------------------------

### Example install-addon command with sample OCID

Source: https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengistio-cluster-add-on.htm

Example command showing the install-addon syntax with a sample cluster OCID and configuration file path.

```bash
oci ce cluster install-addon --addon-name Istio --from-json file://./enableistio.json --cluster-id ocid1.cluster.oc1.iad.aaaaaaaam______dfr
```

--------------------------------

### Get Object with GET

Source: https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/usingpreauthenticatedrequests_topic-Working_with_PreAuthenticated_Requests.htm

Getting an object using a pre-authenticated request. The example shows a GET command with a unique PAR URL and a concrete example URL.

```bash
$ curl -X GET unique_PAR_URL
                
```

```bash
$ curl -X GET https://objectstorage.us-phoenix-1.oraclecloud.com/p/MR7rGASetBbu4L1R5ZH91meUZJjVkOGmd4rtnjDhazP9o6s2KzLyFUxILQzSamEp/n/MyNamespace/b/MyParBucket/o/OCI_User_Guide.pdf
'@data.1''@data.2''@data.3'
```

--------------------------------

### Create example source directory and file

Source: https://docs.oracle.com/en-us/iaas/Content/data-flow/tutorial/use-your-delegation-token/overview.htm

Creates the example source directory structure and an empty file to paste the OboTokenClientConfiguration code into.

```bash
$ mkdir -p src/main/java/example/
$ touch src/main/java/example/OboTokenClientConfigurator.java
```

--------------------------------

### Get installed package info with rpm

Source: https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/dotnetsdkgettingstarted.htm

Gets information about the installed oci-dotnet-sdk package.

```bash
rpm  -qi oci-dotnet-sdk
```

--------------------------------

### Run Producer.go: go mod init, go mod tidy, go run

Source: https://docs.oracle.com/en-us/iaas/Content/Streaming/Tasks/streaming-quickstart-oci-sdk-for-go.htm

Commands to set up and run the Producer.go example. Run them in order from the wd directory: go mod init creates the go.mod file, go mod tidy installs the OCI SDK for Go and Streaming, and go run Producer.go executes the example.

```bash
go mod init oss_producer_example/v0
```

```bash
go mod tidy
```

```bash
go run Producer.go
```

--------------------------------

### CLI: Example command with sample values

Source: https://docs.oracle.com/en-us/iaas/Content/Block/Tasks/create-cross-region-replication-bv-boot-volume.htm

Example of the `oci bv boot-volume create` command with sample values for the source boot volume, compartment, and replica details.

```bash
oci bv boot-volume create --source-boot-volume-id ocid1.bootvolume.oc1.phx.<unique_ID> --compartment-id ocid1.compartment.oc1.phx.<unique_ID> --boot-volume-replicas '[{"displayName":"Sample_Replica","availabilityDomain":"pjBI:US-ASHBURN-AD-1","xrrKmsKeyId" : "ocid1.key.oc1.iad-ad-1.<unique_ID>"}]'
```

--------------------------------

### curl GET example

Source: https://docs.oracle.com/en-us/iaas/Content/APIGateway/Tasks/apigatewayinvokingdeployedapi.htm

Example curl command using the GET method to call a deployed API.

```bash
curl -k -X GET https://lak...sjd.apigateway.us-phoenix-1.oci.customer-oci.com/marketing/hello/
```

--------------------------------

### Ingest and retrieve document with k-NN index

Source: https://docs.oracle.com/en-us/iaas/Content/search-opensearch/Concepts/ocigenaiconnector.htm

Ingests a document into the index using the ingestion pipeline, then retrieves it with a GET request and starts ingesting a second document. The document text is an example passage about antibiotic resistance.

```json
PUT /conversation-demo-index-knn/_doc/1
{
    "text": "The emergence of resistance of bacteria to antibiotics is a common phenomenon. Emergence of resistance often reflects evolutionary processes that take place during antibiotic therapy. The antibiotic treatment may select for bacterial strains with physiologically or genetically enhanced capacity to survive high doses of antibiotics. Under certain conditions, it may result in preferential growth of resistant bacteria, while growth of susceptible bacteria is inhibited by the drug. For example, antibacterial selection for strains having previously acquired antibacterial-resistance genes was demonstrated in 1943 by the Luria–Delbrück experiment. Antibiotics such as penicillin and erythromycin, which used to have a high efficacy against many bacterial species and strains, have become less effective, due to the increased resistance of many bacterial strains."
   
}
GET /conversation-demo-index-knn/_doc/1
PUT /conversation-demo-index-knn/_doc/2
```

--------------------------------

### Example: list add-on options for v1.25.4

Source: https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/list-add-ons.htm

Example of listing available add-on versions for Kubernetes version v1.25.4.

```bash
oci ce addon-option list --kubernetes-version v1.25.4
```

--------------------------------

### CLI: Get image details using OCID (example)

Source: https://docs.oracle.com/en-us/iaas/Content/Registry/Tasks/registryviewingimagedetails.htm

Example of the oci artifacts container image get command with a sample OCID.

```bash
oci artifacts container image get --image-id ocid1.containerimage.oc1.phx.0.ansh81vru1zp.aaaaaaaalqzjyks...
```

--------------------------------

### Install agent with default configuration

Source: https://docs.oracle.com/en-us/iaas/Content/access-governance/agent-administration.htm

Example of installing the agent with default configuration, using sample paths for volume and agent package.

```bash
curl https://raw.githubusercontent.com/oracle/docker-images/main/OracleIdentityGovernance/samples/scripts/agentManagement.sh -o agentManagement.sh ; sh agentManagement.sh \
--volume /access-governance/agent-management/volume \
--agentpackage /access-governance/agent-management/agent-package-<version>.zip \
--agentid myagent \
–-install

```

--------------------------------

### Example: Get listing details with OCI CLI

Source: https://docs.oracle.com/en-us/iaas/Content/Marketplace/Tasks/view-listing.htm

Example of the `oci marketplace listing get` command using a specific listing ID (29367738).

```bash
oci marketplace listing get --listing-id 29367738
```

--------------------------------

### Run the Go SDK example

Source: https://docs.oracle.com/en-us/iaas/Content/API/Concepts/cloudshellquickstart_go.htm

Runs the main.go file to execute the Go SDK example.

```bash
go run main.go
```

--------------------------------

### Create Example.java file

Source: https://docs.oracle.com/en-us/iaas/Content/data-flow/tutorial/use-your-delegation-token/overview.htm

Command to create the Example.java file in the Maven project structure.

```bash
$ touch src/main/java/example/Example.java
```

--------------------------------

### Filter: userName contains example or starts with my

Source: https://docs.oracle.com/en-us/iaas/Content/Identity/api-getstarted/OCISQueryParameters.htm

URL-encoded filter combining two conditions with 'or' to search for users with userName containing 'example' or starting with 'my'.

```http
https://<domainURL>/admin/v1/Users?filter=userName+co+%22example%22+or+userName+sw+%22my%22
```

--------------------------------

### Example: list options for KubernetesDashboard on v1.25.4

Source: https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/list-add-ons.htm

Example of listing available versions of the KubernetesDashboard add-on for Kubernetes version v1.25.4.

```bash
oci ce addon-option list --kubernetes-version v1.25.4 --addon-name KubernetesDashboard
```

--------------------------------

### List Objects with GET

Source: https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/usingpreauthenticatedrequests_topic-Working_with_PreAuthenticated_Requests.htm

Getting a list of objects using a pre-authenticated request that applies to several objects. The example shows a GET command with a unique PAR URL and a concrete example URL with the response listing object names.

```bash
$ curl -X GET unique_PAR_URL
                
```

```bash
$ curl -X GET https://objectstorage.us-phoenix-1.oraclecloud.com/p/2WOshPVWv9uqIqy6abokChGEXYdCZ8l75CoO26YkSARiRevWlDWJD_QUvtFPUocn/n/MyNamespace/b/MyParBucket/o/
{"objects":[{"name":"InfoWorld DeepDive - Tips  for Git and GitHub Users.pdf"},{"name":"OCI_User_Guide.pdf"},{"name":"OracleCorporateTerminologyUsageGuideRedwood.pdf"},{"name":"VPN.png"},{"name":"eventslogreference.htm"},{"name":"functionslogreference.htm"},{"name":"glob.txt"},{"name":"loadbalancerreference.htm"},{"name":"objectstoragelogreference.htm"},{"name":"servicechanges.html"},{"name":"servicediscovery.dita"},{"name":"serviceessentials.html"},{"name":"servicelogreference.htm"},{"name":"services.html"},{"name":"udx-1494-lifecycle-rule-glob.pdf"}]}
```
Tokens:
Raw