Installer ScriptΒΆ
Run the following command to install the oci-ansible-collection and its dependencies.
curl -L https://raw.githubusercontent.com/oracle/oci-ansible-collection/master/scripts/install.sh | bash -s -- --verbose
Warning
On some Linux distributions, python-venv
support is not there. The script installs the necessary dependencies which require sudo
access. Ensure that the current user has sudo permissions before beginning to install the script.
You can also pass arguments to the script for a custom installation. To list all the supported arguments run the following command.
curl -L https://raw.githubusercontent.com/oracle/oci-ansible-collection/master/scripts/install.sh | bash -s -- --help
# List of supported arguments
--virtual-env-dir
Users can use this flag to specify the location where the virtual environment is located or should be created
if not already present. If this path already exists then it will be used else it will be created.
default value: ~/lib
--virtual-env-name
Users can use this flag to specify the python virtual env name where
python dependencies for oci-ansible-collections will be installed.
This virtual env is created in the path sepcified in --virtual-env-dir flag else in the default folder path
used by --virtual-env-dir flag.
default value: oci-ansible-collection
--ansible-version
Users can specify particular version of ansible python package they want to install. Ex: 2.9
To use the latest version dont't set this flag (recommended).
This flag doesn't support upgrading the version in case user has already installed ansible
and wants to upgrade to a higher version.
default value: latest version will be installed
--oci-ansible-collection-path
Users can use this flag to specify the location of collections where oci-ansible-collection
will be installed. Default path for this is determined by ansible-galaxy installer.
--version
Users can use this flag to specify the version of oci-ansible-collection will be installed.
To use the latest version don't set any value(recommended). If not specified the latest
version will be used.
Ex: 2.20.0
Speciying --version along with --upgrade will result in a conflict
Error will raised and installation will not continue.
default value: latest version is picked
--python-path
Users can specify the specific python they want to use for installation.
Note: minimum python version supported is python3.6
--verbose
Users can use this flag to enable more loggings in case of debugging purpose.
Disabled by default.
Ex: --verbose will enable logging
--dry-run
Runs the script in dry run mode i.e no network calls during installation and installation of dependecies.
Disabled by default.
Ex: --dry-run will enable the dry run mode
--upgrade
Users can specify this to upgrade the oci-ansible-collection and its required dependencies.
This is will upgrade oci package and oci-ansible-collection to the latest one.
Note: This will not upgrade ansible dependency to the latest version.
Speciying --version along with --upgrade will result in a conflict
Error will raised and installation will not continue.
--help|-h
Show help section