Skip to content

oracle-samples/oci-vscode-toolkit

Repository files navigation

OCI Toolkit for VS Code

OCI Toolkit for VS Code is a rich collection of OCI extensions, making it easier for you to develop, test, and deploy applications on Oracle Cloud Infrastructure (OCI) straight from VS Code.

OCI toolkit for VS Code is available from the Visual Studio Marketplace

OCI Services

  • Resource Manager extension allows you to edit, plan and deploy Resource Manager Configurations stored in Object Storage or a Code repository. For more information, see the Resource Manager Walkthrough

  • Functions extension in the VS Code lets you create a new function, edit an existing function and deploy and invoke it. For more information, see the Functions Walkthrough

  • Data Science extension allows you to edit your job artifacts and run Data Science jobs natively. For more information, see the Data Science Walkthrough

  • OCI CLI allows users to perform common platform actions, such as creating and managing OCI resources using the built-in OCI CLI in the VS Code terminal

Installation

Installing the OCI VS Code toolkit installs all of the extensions along with the OCI Core extension

You can easily uninstall individual extensions if you are not interested in using them, without affecting other extensions provided by this pack. Additionally, you can uninstall all of the extensions by uninstalling the OCI VS Code toolkit extension.

Minimum policies required

Allow group to inspect compartments in tenancy

Sign-In

The plugin requires basic configuration information, like user credentials and tenancy OCID. This information should be present in a configuration file located at ~/.oci/config

There are two ways to get the config file

  1. Auto-generate file using Sign In Button:

    On successful login, a config file will be generated and saved in ~/.oci folder

  2. Manually generate a file and save it in the ~/.oci folder:

    Details on generating the configuration file can be found here

Switch-Region

The user can switch to different subscribed OCI regions from this wizard.

OCI CLI

The OCI Toolkit for VS Code comes with the OCI CLI. Users can effortlessly perform common platform actions, such as creating and managing OCI resources using the built-in OCI CLI in the VS Code terminal. Further, leverage the OCI CLI's interactive mode to simplify resource management tasks with command and parameter suggestions, auto-completing, and command reference information.

Enable interactive mode on your terminal with the below command from the Command Palette:

Toggle Interactive CLI

Documentation

Full documentation, including prerequisites, supported vscode versions and configuration instructions, is available here.

Contributing

This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide

Security

Please consult the security guide for our responsible security vulnerability disclosure process

License

Copyright (c) 2022, 2023, Oracle and/or its affiliates. All rights reserved.This software is licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl.

See LICENSE for more details.