From 9f42fe061fd5a4529a97b2a1f20fd8d1a9d46159 Mon Sep 17 00:00:00 2001 From: Daniel Gubay Date: Wed, 28 Jun 2023 11:22:33 -0500 Subject: [PATCH 1/5] updated oci-cli install guide --- content/install-guides/oci-cli.md | 24 +++++++++++++++++------- 1 file changed, 17 insertions(+), 7 deletions(-) diff --git a/content/install-guides/oci-cli.md b/content/install-guides/oci-cli.md index d72a2cf3e..41b289d43 100644 --- a/content/install-guides/oci-cli.md +++ b/content/install-guides/oci-cli.md @@ -55,18 +55,28 @@ Install OCI using the command below. ```bash { target="ubuntu:latest" } bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)" ``` -You are prompted by the installation script with the following questions: -- In what directory would you like to place the install? (leave blank to use '/home/ubuntu/lib/oracle-cli'): -- In what directory would you like to place the 'oci' executable? (leave blank to use '/home/ubuntu/bin'): -- In what directory would you like to place the OCI scripts? (leave blank to use '/home/ubuntu/bin/oci-cli-scripts'): -- What optional CLI packages would you like to be installed (comma separated names; press enter if you don't need any optional packages)?: +To run a 'silent' install that accepts all default values with no prompts, use the --accept-all-defaults parameter. + +Otherwise respond to the Installation Script Prompts if you wish to make a change. + -You can press Enter for the the default selection on all the questions or enter the path to a directory of your choice. -Verify OCI CLI installed: +Verify OCI CLI installed. ```bash { target="ubuntu:latest" } oci --version +``` + + Run the command below to have OCI work after the initial install. + +```bash { target="ubuntu:latest" } +source $HOME/.bashrc +``` + + +Run the command below to get started on OCI. +```bash { target="ubuntu:latest" } +oci setup config ``` After a successful log in, you can use the [OCI CLI](../oci-cli) and automation tools like [Terraform](../terraform) from the terminal. From c90b753be55f53d91b9145eb535cab34517ead83 Mon Sep 17 00:00:00 2001 From: Daniel Gubay Date: Thu, 29 Jun 2023 13:27:06 -0500 Subject: [PATCH 2/5] added OCID, and api key steps --- content/install-guides/oci-cli.md | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/content/install-guides/oci-cli.md b/content/install-guides/oci-cli.md index 41b289d43..18154282f 100644 --- a/content/install-guides/oci-cli.md +++ b/content/install-guides/oci-cli.md @@ -55,7 +55,12 @@ Install OCI using the command below. ```bash { target="ubuntu:latest" } bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)" ``` -To run a 'silent' install that accepts all default values with no prompts, use the --accept-all-defaults parameter. +Hit return for the first prompt then run accept all. To run a 'silent' install that accepts all default values with no prompts, use the --accept-all-defaults parameter. + + +```bash { target="ubuntu:latest" } + --accept-all-defaults +``` Otherwise respond to the Installation Script Prompts if you wish to make a change. @@ -79,4 +84,17 @@ Run the command below to get started on OCI. oci setup config ``` + +After 'oci setup config' login to the OCI web console to access your OCID and API key you will need this later. + +To locate your OCID you open the Profile menu and click Tenancy: . + +![alt-text #center](https://user-images.githubusercontent.com/89662128/249609571-34848e91-c4a5-4266-b5e3-45d48f797de9.png) + + +To locate your API KEYS open your profile and click API KEYS: + +![alt-text #center](https://user-images.githubusercontent.com/89662128/249819544-faa03f40-6d4f-448a-aaef-25870cf3a48c.jpeg "Click add API key, from there generate your API key pair") + + After a successful log in, you can use the [OCI CLI](../oci-cli) and automation tools like [Terraform](../terraform) from the terminal. From bc63de42c10945354ee2e7198ac0e208a7c6244b Mon Sep 17 00:00:00 2001 From: Jason Andrews Date: Thu, 29 Jun 2023 14:52:25 -0500 Subject: [PATCH 3/5] edits to OCI CLI intall guide --- content/install-guides/oci-cli.md | 44 +++++++++++++++---------------- 1 file changed, 21 insertions(+), 23 deletions(-) diff --git a/content/install-guides/oci-cli.md b/content/install-guides/oci-cli.md index 18154282f..cd5a830af 100644 --- a/content/install-guides/oci-cli.md +++ b/content/install-guides/oci-cli.md @@ -22,7 +22,7 @@ tool_install: true weight: 1 --- -[OCI CLI](https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/cliinstall.htm) is a cross-platform command-line tool that can be installed locally on development computers. OCI CLI is used to connect to OCI and execute administrative commands on OCI resources. +The Oracle Cloud Infrastructure Command Line Interface (OCI CLI) is a cross-platform command-line tool that can be installed locally on development computers. OCI CLI is used to connect to OCI and execute administrative commands on OCI resources. It is available for a variety of operating systems and Linux distributions and has multiple ways to install it. @@ -48,53 +48,51 @@ If you see a different result, you are not using an Arm computer running 64-bit ## Download and Install -The easiest way to install OCI CLI for Ubuntu on Arm is to use the installer script. +The easiest way to install OCI CLI for Ubuntu on Arm is to use the install script. -Install OCI using the command below. - -```bash { target="ubuntu:latest" } -bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)" -``` -Hit return for the first prompt then run accept all. To run a 'silent' install that accepts all default values with no prompts, use the --accept-all-defaults parameter. +You can run an automated install with default values or an interactive install to change the default values. +To run an an automated install with default values run: ```bash { target="ubuntu:latest" } - --accept-all-defaults +curl -o install.sh https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh +bash ./install.sh --accept-all-defaults ``` -Otherwise respond to the Installation Script Prompts if you wish to make a change. - +To run an interactive install that allows you to change default values run: +```console +bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)" +``` -Verify OCI CLI installed. +Run the command below to add the `oci` command to your search path: ```bash { target="ubuntu:latest" } -oci --version +source $HOME/.bashrc ``` - Run the command below to have OCI work after the initial install. +Verify OCI CLI is installed using the `--version` option: -```bash { target="ubuntu:latest" } -source $HOME/.bashrc +```bash { target="ubuntu:latest", env_source="~/.bashrc" } +oci --version ``` +Configure OCI CLI using the `setup config` command: -Run the command below to get started on OCI. -```bash { target="ubuntu:latest" } +```console oci setup config ``` +To complete the setup you will need your OCID and API key. -After 'oci setup config' login to the OCI web console to access your OCID and API key you will need this later. +Log in to the OCI web console to access your OCID and API key. -To locate your OCID you open the Profile menu and click Tenancy: . +Open the Profile menu and click Tenancy: to locate your OCID. ![alt-text #center](https://user-images.githubusercontent.com/89662128/249609571-34848e91-c4a5-4266-b5e3-45d48f797de9.png) - To locate your API KEYS open your profile and click API KEYS: ![alt-text #center](https://user-images.githubusercontent.com/89662128/249819544-faa03f40-6d4f-448a-aaef-25870cf3a48c.jpeg "Click add API key, from there generate your API key pair") - -After a successful log in, you can use the [OCI CLI](../oci-cli) and automation tools like [Terraform](../terraform) from the terminal. +After a successful log in, you can use the OCI CLI and automation tools like [Terraform](../terraform) from the terminal. From c26d2481dbc67dccedb4d8237936f5ef54adfb9a Mon Sep 17 00:00:00 2001 From: Jason Andrews Date: Thu, 29 Jun 2023 15:06:32 -0500 Subject: [PATCH 4/5] add spelling exceptions --- .wordlist.txt | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/.wordlist.txt b/.wordlist.txt index 36b5f0fa6..88cec4b04 100644 --- a/.wordlist.txt +++ b/.wordlist.txt @@ -1414,4 +1414,18 @@ rst hwcaps softWare Inspiron -Brossard \ No newline at end of file +Brossard +textinstall +Gubay +SDKDocs +cliinstall +htm +ral +IG +keygen +trgt +bstn +OCID +oci +githubusercontent +iaas \ No newline at end of file From 0f3392e6b4b072348df6a0be909c811ea6ec7722 Mon Sep 17 00:00:00 2001 From: Jason Andrews Date: Thu, 29 Jun 2023 15:12:34 -0500 Subject: [PATCH 5/5] add spelling exceptions --- .wordlist.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.wordlist.txt b/.wordlist.txt index 88cec4b04..42eee506e 100644 --- a/.wordlist.txt +++ b/.wordlist.txt @@ -1428,4 +1428,5 @@ bstn OCID oci githubusercontent -iaas \ No newline at end of file +iaas +ipexplorer