Skip to content

Commit 49ea155

Browse files
Releasing version 3.23.3
Releasing version 3.23.3
2 parents 31e7a1b + 9c7b866 commit 49ea155

File tree

124 files changed

+2388
-1242
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

124 files changed

+2388
-1242
lines changed

CHANGELOG.rst

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,72 @@ All notable changes to this project will be documented in this file.
66

77
The format is based on `Keep a Changelog <http://keepachangelog.com/>`__.
88

9+
3.23.3 - 2023-03-07
10+
--------------------
11+
Added
12+
~~~~~
13+
* Database service
14+
15+
* Support for autonomous database long-term backup schedule
16+
17+
* ``oci db autonomous-database update --long-term-backup-schedule``
18+
* ``oci db autonomous-database update --long-term-backup-schedule``
19+
20+
* Support for autonomous database long-term backup
21+
22+
* ``oci db autonomous-database-backup create --retention-period-in-days --is-long-term-backup``
23+
* ``oci db autonomous-database-backup update``
24+
* ``oci db autonomous-database-backup delete``
25+
26+
* Support for Model Deployment resource to use a customized container image containing runtime dependencies of ML Model and custom web server to handle inference requests in the Data Science service
27+
28+
* ``oci data-science model-deployment create``
29+
* ``oci data-science model-deployment update``
30+
* ``oci data-science model-deployment activate``
31+
* ``oci data-science model-deployment get``
32+
* ``oci data-science model-deployment list``
33+
34+
* Support for Disaster Recovery in the Oracle Content Management service
35+
36+
* ``oci oce oce-instance create --dr-region``
37+
* ``oci oce oce-instance update --dr-region --lifecycle-details``
38+
39+
* Operations Insights service
40+
41+
* Support for Full Features for Autonomous Databases
42+
43+
* ``oci opsi database-insights enable-autonomous-database-insight-advanced-features``
44+
* ``oci opsi database-insights disable-autonomous-database-insight-advanced-features``
45+
* ``oci opsi database-insights change-autonomous-database-insight-advanced-features``
46+
47+
* Support for new optional parameters
48+
49+
* ``oci opsi database-insights summarize-database-insight-resource-capacity-trend --high-utilization-threshold --low-utilization-threshold``
50+
* ``oci opsi database-insights summarize-database-insight-resource-forecast-trend --high-utilization-threshold --low-utilization-threshold``
51+
* ``oci opsi database-insights summarize-database-insight-resource-statistics --high-utilization-threshold --low-utilization-threshold``
52+
* ``oci opsi database-insights summarize-database-insight-resource-usage --cdb-name``
53+
* ``oci opsi database-insights summarize-database-insight-resource-usage-trend --cdb-name``
54+
* ``oci opsi database-insights summarize-database-insight-resource-utilization-insight --cdb-name --high-utilization-threshold --low-utilization-threshold``
55+
* ``oci opsi database-insights summarize-sql-insights --vmcluster-name``
56+
57+
* Support for new optional flag in instance update API of Compute Service
58+
59+
* ``oci compute instance update --update-operation-constraint``
60+
61+
* Support for new parameters in Management Agent's service
62+
63+
* ``oci management-agent agent summarize-agent-counts --compartment-id-in-subtree``
64+
* ``oci management-agent agent summarize-plugin-counts --compartment-id-in-subtree``
65+
* ``oci management-agent agent list --gateway-id``
66+
67+
Changed
68+
~~~~~~~
69+
* Documentation change for Language codes supported as Text Translation now supports Hebrew and Greek as well and addition of support for auto-detection in AI Language text analyze with pretrained models
70+
71+
* Changed no passphrase indication for RSA keys from empty to "N/A"
72+
* ``oci setup config``
73+
* ``oci setup keys``
74+
975
3.23.2 - 2023-02-28
1076
--------------------
1177
Added

conftest.py

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -158,7 +158,6 @@ def config(config_file, config_profile):
158158
return config
159159

160160

161-
@pytest.fixture(scope="session")
162161
def runner():
163162
# click does not distinguish between stdout and stderr in Result.output so we are wrapping invoke to strip out common stderr warnings
164163
# this allows the output to be json parseable which many tests expect
@@ -174,7 +173,7 @@ def invoke(*args, **kwargs):
174173
except TypeError:
175174
new_output_bytes = cleaned_output
176175
finally:
177-
result = click.testing.Result(result.runner, new_output_bytes, result.exit_code, result.exception, result.exc_info)
176+
result = click.testing.Result(result.runner, new_output_bytes, result.stderr_bytes, result, result.exit_code, result.exception, result.exc_info)
178177

179178
return result
180179

requirements.txt

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,23 +6,24 @@ appdirs==1.4.3
66
arrow>=1.0.0
77
certifi
88
cffi>=1.9.1
9-
click==7.1.2
9+
click==8.0.4
1010
coverage==4.5.2
1111
cryptography>=3.2.1,<39.0.0
1212
httpsig-cffi==15.0.0
1313
Jinja2==3.0.3
1414
jmespath==0.10.0
1515
ndg-httpsclient==0.4.2
1616
mock==2.0.0
17-
oci==2.93.1
17+
oci==2.94.0
1818
packaging==20.2
1919
pluggy==0.13.0
2020
py==1.10.0
2121
pyasn1==0.2.3
2222
pyOpenSSL>=17.5.0,<=22.1.0
2323
pycparser==2.20
2424
pyparsing==2.2.0
25-
pytest==3.2.3
25+
pytest==4.6.10; python_version <= '3.9'
26+
pytest==7.1.2; python_version >= '3.10'
2627
pytest-cov==2.5.1
2728
python-dateutil>=2.5.3,<3.0.0
2829
pytz>=2016.10
@@ -32,7 +33,8 @@ sphinx==3.3.0
3233
sphinx-rtd-theme==0.4.3
3334
terminaltables==3.1.0
3435
tox==3.23.0
35-
vcrpy==1.13.0
36+
vcrpy==1.13.0; python_version <= '3.9'
37+
vcrpy==4.2.1; python_version >= '3.10'
3638
virtualenv==20.13.0
3739
pytest-xdist==1.22.2
3840
pytest-forked==1.0.2

scripts/examples/project_o/README.md

Lines changed: 53 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -49,15 +49,35 @@ Public Subnet VLKn:US-ASHBURN-AD-1 AVAILABLE 10.0.0.0/24 sales
4949

5050
## Installation
5151

52-
**``o``** is a single file. To install, download **``o``**, place it in your PATH (probably in the same place as ``oci``), and make it executable.
53-
**``o``** works in Linux, Mac, WSL and CloudShell.
52+
**Pre-reqs:** **``o``** works in Linux, Mac, WSL and CloudShell. `oci` must installed and configured. `o` does not replace `oci`, but it *uses* `oci`. See [Requirements](#requirements) below for more details.
5453

55-
Use these commands to get ``o`` from github and install it next to ``oci``.
54+
**``o``** is a single file. To install, get **``o``** from github, place it in your PATH (probably in the same place as ``oci``), and make it executable. Use these commands to download ``o`` and install it next to ``oci``.
55+
<a name="install"></a>
5656
```
5757
o_src=https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/examples/project_o/o
5858
where=$(which oci) && to=${where%ci} && wget -q $o_src -O $to && chmod a+x $to
5959
```
60-
When you first run `o` it will tell you how to create the commands file *$HOME/.oci/oci_commands*, and then `o` helps you to initialize your *$HOME/.oci/ocids* file.
60+
#### Setup
61+
62+
When you first run `o` it will tell you run `o oci_commands` to create the commands file *$HOME/.oci/oci_commands*. This collects a list of all possible `oci` commands with usage details.
63+
64+
Then `o` asks you to run `o <tenancy_ocid>` to initialize your *$HOME/.oci/ocids*. This seeds your *ocids* file with OCIDs of the compartments in your tenancy.
65+
66+
#### Updates and maintenance
67+
68+
Check this page for updates... See [New in version](#newinversion) sections below, and compare the latest with the version shown in `o help`.
69+
70+
To install an `o` update, just re-run the two-line [installation command](#install) above.
71+
72+
Update `oci` every few months (or more frequently to keep up with the latest service additions). See [Upgrading the CLI](https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/cliupgrading.htm).
73+
74+
Run `o oci_commands` every couple of months to update *$HOME/.oci/oci_commands* with commands for the latest services added to OCI.
75+
76+
Keep using your existing *$HOME/.oci/ocids* file. If, however, it becomes unusable (with old data) or you want a fresh start, simply remove it and create a new one:
77+
- `rm $HOME/.oci/ocids`
78+
- `o <tenancy_ocid>`
79+
80+
This will get a fresh list of all compartments in the tenancy, which is a great starting point.
6181

6282
## Things you can do with ``o``
6383

@@ -102,28 +122,35 @@ When you first run `o` it will tell you how to create the commands file *$HOME/.
102122
- `o ocid sales/bastion` *instantly* shows the full OCIDs for the specified compartment
103123

104124
#### New in version 1.3 (2022-12-15)
105-
- get next page of results with `o <repeat-last-command> -page next`
106-
- select child fields from complex output with `-o key.subkey`
107-
- first use `o -o / <command> .` to see all available data fields
108-
- then rerun with desired `-o key#key.subkey` list.
109-
- save `oci` output (or `o -o json` output) to a file, then format with `o` - useful for getting the format just right
110-
- `o -o json list compute instances > data.json`
111-
- `o -i data.json -o name#id#date`
125+
- Get next page of results with `o <repeat-last-command> -page next`
126+
- Select child fields from complex output with `-o key.subkey`
127+
- first use `o -o / <command> .` to see all available keys, then rerun with desired output list
128+
- Example: `o -o +shape-conf.ocpus#shape-conf.memory` list compute inst -c sales .`
129+
- Take JSON input from file. Useful for getting the format just right
130+
- First save `oci` output (or output from `o -o json`) to a file
131+
- `o -o json list compute instances > list.json`
132+
- Then use that as input to `o`
133+
- `o -i list.json -o name:20#id:-.10#created:.10`
112134

113135
#### New in version 1.4 (2023-01-20)
114-
- replace compartment names with OCIDs in:
115-
- `oci search resource structured-search --query-text <text>`
116-
- `oci logging-search search-logs --search-query <text>`
117-
- easier output formatting. Braces are optional, allow ":-" instead of ":>" for right-justify
118-
- `o -o id:-.10#name:6#create:.10 comp inst list`
119-
- table output with right-most 10 characters of `id`, `display-name` in 6 (or more) characters, and first 10 characters of `time-created`
120-
121-
#### New in version 1.5 (2023-02-07)
122-
- show additional output fields (not in "data") like object storage "prefixes"
123-
- Keep default output fields and
124-
- change format style with separator: `-o +/`
125-
- append additional fields: `-o +new#fields`
126-
- change format and append: `-o +new/fields`
136+
- Assist with compartment names with OCIDs in some searches:
137+
- `o structured-search --query-text 'query instance resources where compart=sales'`
138+
- `o logging-search -sq 'search sales' -ts yesterday -te today`
139+
- Easier custom output formatting:
140+
- braces are optional
141+
- allow ":-" instead of ":>" for right-justify (so quotes aren't needed around the ">")
142+
- Example: For table output with right-most 8 characters of `id`, 10 (or more) characters of `display-name`, and first 10 characters (no more than 10) of `time-created`
143+
- `o -o id:-.8#name:10#create:.10 comp inst list`
144+
145+
<a name="newinversion"></a>
146+
#### New in version 1.5 (2023-02-28)
147+
- If you like the default output but want to add another field use `-o +field`:
148+
- Example: `o -o +subnet list-vnics -c sales`
149+
- If you like the default output fields, but want to change the format style, just add the separator:
150+
- change to "text" output: `o -o +/ <command>`
151+
- change to CSV output: `o -o +, <command>`
152+
- change to "text" and add fields: `-o +/subnet list-vnics ...`
153+
- Show additional output fields (not in "data") to stderr, such as "etag" or os "prefixes". Use `o -q` to hide this non-data.
127154

128155
## How **``o``** works
129156
- **``o``** compares your input with thousands of ``oci`` commands, and uses an fuzzy matching to find the command you want.
@@ -140,12 +167,12 @@ When you first run `o` it will tell you how to create the commands file *$HOME/.
140167

141168
- **``o``** scans the JSON results from ``oci`` for key names that match or partially match any of your <nobr>``-o key/word/list``</nobr>. The key words determine *what* presented, while the **``/``** separator character determines *how* they are presented.
142169

143-
## Requirements
170+
## <a name="requirements"></a> Requirements
144171

145172
You will need:
146173

147174
- MacOS, Linux or WSL.
148-
- Python 3.6+. If ``oci`` is installed, you have Python.
175+
- Python 3.6+. If ``oci`` is installed, you have Python. (`oci` works better with python 3.7+)
149176
- ``oci`` - The Oracle Cloud Infrastructure command line interface must be *installed and configured*.
150177
- Try running ``oci os ns get`` to verify that it's working.
151178
- See https://docs.cloud.oracle.com/en-us/iaas/Content/API/SDKDocs/cliinstall.htm

0 commit comments

Comments
 (0)