Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merge to production #376

Merged
merged 8 commits into from
Jun 29, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 16 additions & 1 deletion .wordlist.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1414,4 +1414,19 @@ rst
hwcaps
softWare
Inspiron
Brossard
Brossard
textinstall
Gubay
SDKDocs
cliinstall
htm
ral
IG
keygen
trgt
bstn
OCID
oci
githubusercontent
iaas
ipexplorer
50 changes: 38 additions & 12 deletions content/install-guides/oci-cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -48,25 +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.
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" }
bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"
curl -o install.sh https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh
bash ./install.sh --accept-all-defaults
```
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)?:

You can press Enter for the the default selection on all the questions or enter the path to a directory of your choice.
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" }
source $HOME/.bashrc
```

Verify OCI CLI is installed using the `--version` option:

```bash { target="ubuntu:latest", env_source="~/.bashrc" }
oci --version
```

After a successful log in, you can use the [OCI CLI](../oci-cli) and automation tools like [Terraform](../terraform) from the terminal.
Configure OCI CLI using the `setup config` command:

```console
oci setup config
```

To complete the setup you will need your OCID and API key.

Log in to the OCI web console to access your OCID and API key.

Open the Profile menu and click Tenancy: <your_tenancy_name> 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 and automation tools like [Terraform](../terraform) from the terminal.