Skip to content

Commit

Permalink
Merge pull request #376 from ArmDeveloperEcosystem/main
Browse files Browse the repository at this point in the history
Merge to production
  • Loading branch information
jasonrandrews authored Jun 29, 2023
2 parents 803c076 + ec2c4b4 commit 0d5075c
Show file tree
Hide file tree
Showing 2 changed files with 54 additions and 13 deletions.
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.

0 comments on commit 0d5075c

Please sign in to comment.