Skip to content

Latest commit

 

History

History
115 lines (89 loc) · 4.57 KB

oci.md

File metadata and controls

115 lines (89 loc) · 4.57 KB

OCI Integration

Ops can integrate with your existing Oracle Cloud Infrastructure account. You can use Ops CLI to create and upload an image in OCI account. Once, you have uploaded image, you can also create an instance with a particular image using CLI.

Pre-requisites

  1. Create an Oracle Cloud Infrastructure account (https://www.oracle.com/cloud/).
  2. Set up a config file with the required credentials.
    1. Go to User Settings page, whose link should be seen after clicking on profile avatar in top navigation bar.
    2. Click on API Keys link.
    3. Click on Add API Key button. A modal with further instructions will appear.
    4. Download the private key.
    5. Click on Add button. You should see a configuration preview in the modal.
    6. Copy configuration preview content to ~/.oci/config file in your machine. Create the directory .oci in your home folder if it does not exist yet.
    7. Update the key_file in OCI configuration file with the path of the file you downloaded in step 4.
  3. Setup a bucket in your OCI account to receive your images.
    1. Access Object Storage page.
    2. Click on Create Bucket button.
    3. Access bucket details page and copy Namespace value to ops configuration file.
  4. Copy your bucket details to ops configuration.
{
  "CloudConfig": {
    "BucketName": "<bucket_name>",
    "BucketNamespace": "<bucket_namespace>"
  }
}
  1. You are now able to use ops commands to interact with your OCI Account
# OCI configuration file preview
[DEFAULT]
user=ocid1.user.oc1..<user_ocid>
fingerprint=38:9d:75:00:71:6c:b7:e0:21:d4:08:82:e4:db:bc:a7
tenancy=ocid1.tenancy.oc1..<tenancy_ocid>
region=<region>
key_file=<path to your private keyfile> # TODO

Image Operations

Create Image

You can create an image in OCI with the following command.

$ ops image create <elf_file|program> -t oci -c config.json

For creating an image using a particular package, you need to provide the package name to ops image create command with -p option.

$ ops image create -c config.json -p node_v14.2.0 -a ex.js -i <image name> -t oci -c config.json

List Images

You can list existing images on OCI with ops image list -t oci -c config.json.

$ ops image list -t oci -c config.json
+--------------------------------------+------------------------+--------+---------+------------------+
|                 UUID                 |          NAME          | STATUS |  SIZE   |    CREATEDAT     |
+--------------------------------------+------------------------+--------+---------+------------------+
| 01071a8d-eb59-49c1-aa69-028f84cc6d06 | nanos-main-image       | online | 10.0 GB | 3 days ago       |
+--------------------------------------+------------------------+--------+---------+------------------+
| 01c5bd28-aa19-4883-a4c9-31f3ff9fd061 | nanos-node-image       | online | 10.0 GB | 1 month ago      |
+--------------------------------------+------------------------+--------+---------+------------------+
| 01cd3190-df52-47e8-b5c3-b05f7107819e | nanos-server-image     | online | 10.0 GB | 1 year ago       |
+--------------------------------------+------------------------+--------+---------+------------------+

Delete Image

ops image delete <imagename> can be used to delete an image from OCI.

$ ops delete image nanos-main-image -t oci -c config.json

Instance Operations

Create Instance

After the successful creation of an image in OCI, we can create an instance from an existing image.

$ ops instance create <image_name> -t oci -c config.json

List Instances

You can list instance on OCI using ops instance list command.

$ ops instance list -t oci -c config.json
+--------------------------------------+------------------------+---------+-------------+-----------------------------------------+
|                  ID                  |          NAME          | STATUS  | PRIVATE IPS |               PUBLIC IPS                |
+--------------------------------------+------------------------+---------+-------------+-----------------------------------------+
| 00d954cc-9603-43a0-915b-5c2ae75772b6 | nanos-main-image-15566 | stopped | 10.8.3.63   | 209.151.144.166                         |
+--------------------------------------+------------------------+---------+-------------+-----------------------------------------+

Get Logs for Instance

Work in progress.

Delete Instance

ops instance delete command can be used to delete instance on OCI.

$ ops instance delete my-instance-running -t oci -c config.json