Instalações Manuais e Off-line
Esta seção descreve como executar instalações manuais e off-line da CLI (Interface de Linha de Comando) do OCI:
Instalação Manual
Em vez de usar os métodos de instalação descritos no Início Rápido ou usando a imagem do Contêiner da CLI do OCI, você pode instalar manualmente a CLI e suas dependências usando o pip
. Antes de continuar, certifique-se de atender aos Requisitos.
Antes de instalar manualmente a CLI:
- Certifique-se de que o caminho do Python esteja definido corretamente
- Execute "python --version" ou "python3 --version" e verifique se você tem a versão obrigatória
- Se estiver instalando no Oracle Linux ou CentOS, tenha o seguinte instalado:
- gcc
- zlib-devel
- python3-devel
- a versão mais recente do OpenSSL 1.1.1
Você também pode fazer download dos arquivos de instalação da CLI e executar uma instalação off-line.
Etapa 1: Instalando o Python
As instruções de instalação do Python variam para cada sistema operacional suportado pela CLI.
Instale uma versão suportada do Python na página de downloads do Python no Windows. Durante a instalação, escolha adicionar o Python às variáveis PATH e/ou de ambiente (dependendo da solicitação).
Algumas versões do Oracle Linux são fornecidas com versões incompatíveis do Python e podem exigir componentes adicionais para instalar a CLI. Antes de instalar a CLI, execute os comandos a seguir em uma nova imagem do Oracle Linux.
A CLI é pré-instalada no Oracle Linux 9, no Oracle Autonomous Linux versões 7 e 8 e no Oracle Linux Cloud Developer 8.
Oracle Linux 8
sudo dnf -y update
sudo dnf -y groupinstall "Development Tools"
sudo dnf -y install gcc wget openssl-devel bzip2-devel libffi-devel
sudo dnf -y module enable python36 # for Oracle Linux 8
sudo dnf -y install python36 # for Oracle Linux 8
O Python está disponível como módulos de Stream de Aplicativo específicos da versão no Oracle Linux 8 e CentOS 8.
dnf module list
para ver os módulos Python disponíveis no momento. Por exemplo:$ sudo dnf module list | grep python
python36 3.6 [d] build, common [d] Python programming language, version 3.6
python38 3.8 [d] build, common [d] Python programming language, version 3.8
python39 3.9 [d] build, common [d] Python programming language, version 3.9
sudo dnf -y module enable python39
sudo dnf -y install python39
python3.9
Substitua python39
e python3.9
por python36
e python3.6
ou python38
e python3.8
para instalar e usar essas versões.
Oracle Linux 7
sudo yum -y update
sudo yum -y groupinstall "Development Tools"
sudo yum -y install gcc wget openssl-devel bzip2-devel libffi-devel
sudo yum install -y python3 # for Oracle Linux 7
Para o Oracle Linux 7, observe que o
python3-devel
está no repositório ol7_optional_latest
, que pode não estar ativado por padrão. Para instalar o python3-devel
, execute o seguinte em um prompt de shell:sudo yum install -y --enablerepo ol7_optional_latest python3-devel
Detalhes sobre como instalar e usar versões mais recentes do Python disponíveis para o Oracle Linux 7 podem ser encontrados na documentação Oracle Linux Software Collections Library.
Oracle Linux 6
O Oracle Linux 6 não é mais recomendado. Considere usar o Oracle Linux 8.
sudo yum -y update
sudo yum -y groupinstall "Development Tools"
sudo yum -y install gcc wget openssl-devel bzip2-devel libffi-devel
wget https://www.python.org/ftp/python/3.6.3/Python-3.6.3.tgz
tar xvf Python-3.6.3.tgz
cd Python-3.6*/
./configure --enable-optimizations
sudo make altinstall
Antes de instalar a CLI, execute os comandos a seguir em uma nova imagem do CentOS.
CentOS Linux 8
sudo yum -y update
sudo yum -y groupinstall "Development Tools"
sudo yum -y install gcc wget openssl-devel bzip2-devel libffi-devel
sudo dnf -y module enable python36
sudo dnf -y install python36
O Python está disponível como módulos de Stream de Aplicativo específicos da versão no CentOS 8.
Use dnf module list
para ver os módulos Python disponíveis no momento.
sudo dnf module list | grep python
python36 3.6 [d] build, common [d] Python programming language, version 3.6
python38 3.8 [d] build, common [d] Python programming language, version 3.8
python39 3.9 [d] build, common [d] Python programming language, version 3.9
sudo dnf -y module enable python39
sudo dnf -y install python39
python3.9
Substitua python39
e python3.9
por python36
e python3.6
ou python38
e python3.8
para instalar e usar essas versões.
CentOS Linux 7
sudo yum -y update
sudo yum -y groupinstall "Development Tools"
sudo yum -y install gcc wget openssl-devel bzip2-devel libffi-devel
sudo yum install -y python3 # for CentOS Linux 7
Detalhes sobre como instalar e usar versões mais recentes do Python disponíveis para o CentOS 7 podem ser encontrados na documentação do Software Collections.
Antes de instalar a CLI, execute os comandos a seguir em uma nova imagem do Ubuntu.
Ubuntu 16, Ubuntu 18 e Ubuntu 20
sudo apt update
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev libsqlite3-dev wget libbz2-dev
sudo apt update && sudo apt install python3 python3-pip python3-venv
O Mac OS X vem com o Python pré-instalado.
Para instalar a versão mais recente do Python no Mac OS X, consulte a documentação oficial do Python.
Etapa 2: Criando e Configurando um Ambiente Virtual
O módulo Python venv
é um construtor de ambiente virtual que permite criar ambientes Python isolados. Recomendamos instalar a CLI em um ambiente virtual.
Instalando e Ativando o Ambiente Virtual
Após a instalação do Python, configure um ambiente virtual para seu sistema operacional usando as etapas a seguir.
- Navegue até o diretório no qual você gostaria de criar o ambiente virtual.
- Crie o ambiente virtual executando o seguinte comando:
python -m venv oracle-cli
- Ative o ambiente virtual executando o seguinte comando:
oracle-cli/Scripts/activate
- Navegue até o diretório no qual você gostaria de criar o ambiente virtual.
- Crie o ambiente virtual executando um dos seguintes comandos, dependendo da versão do Python instalada:
python3.8 -m venv oracle-cli
python3.6 -m venv oracle-cli
- Ative o ambiente virtual executando o seguinte comando:
source oracle-cli/bin/activate
Etapa 3: Instalando a Interface de Linha de Comando
Você pode fazer o download da CLI por meio do GitHub ou pode instalar o pacote no Python Package Index (PyPI).
Para instalar usando o download do GitHub:
- Faça download do oci-cli.zip e descompacte-o.
- Se desejar, valide o arquivo baixado.
-
Execute o comando a seguir.
pip install oci_cli-*-py2.py3-none-any.whl
Para instalar usando o PyPI, execute o comando a seguir:
pip install oci-cli
Para obter informações sobre como iniciar uma sessão da CLI, consulte Usando a CLI.
Instalação Off-line
Se você tiver uma versão suportada do Python instalada, poderá executar uma instalação off-line da CLI do OCI.
- Vá para a página da release da CLI do OCI no GitHub e selecione a versão da CLI que você deseja instalar.
- Role para baixo até a seção Ativos da página da release e clique no arquivo zip para baixá-lo.
- Se desejar, valide o arquivo baixado.
- Copie o arquivo zip para o host de destino.
- Descompacte o arquivo zip.
- Execute o instalador apropriado para a plataforma:
- No Unix e no Linux, execute
bash install.sh --offline-install
- No Windows, execute
install.ps1 -OfflineInstall
- No Unix e no Linux, execute
- Siga os prompts de instalação.
Para solucionar problemas de instalações off-line, consulte Problemas Comuns ou criar um problema no GitHub.
Instalando sem um Ambiente Virtual
Não recomendamos a instalação da CLI no seu Python em nível de sistema e sugerimos que, em vez disso, você instale a CLI usando o instalador ou um ambiente virtual.
Nos casos em que você está tentando instalar a CLI no seu Python em nível de sistema usando a versão pip mais recente, talvez tenha conflitos com alguns pacotes distutils
instalados. Este é um exemplo de mensagem de erro quando isso ocorre:
sudo pip install oci-cli
...
...
Cannot uninstall 'requests'. It is a distutils installed project and thus we cannot accurately determine which files belong to it which would lead to only a partial uninstall.
Outra opção é instalar a CLI para o usuário usando o seguinte comando, embora essa abordagem não seja suportada:
pip install --user oci-cli
Validando a Soma de Verificação da Release
Após o download do pacote da CLI, você poderá validar a soma de verificação SHA-256. Dependendo do seu sistema operacional, use as instruções a seguir para comparar o valor SHA-256 fornecido na release do Github com o valor que você obtém ao concluir este procedimento para o seu sistema operacional.
- Abra um shell de comando.
- Vá para o diretório no qual está o arquivo de download.
- Execute o seguinte comando para gerar o valor da soma de verificação, em que
filename
é o nome do arquivo baixado em seu computador:certutil -hashfile filename SHA256
- Verifique se o valor da soma de verificação retornada corresponde ao valor SHA-256 fornecido na release do Github. Se os valores não corresponderem, faça download do arquivo novamente e repita este procedimento.
- Abra uma janela de terminal.
- Execute o seguinte comando, em que
fileLocation
é o caminho completo do arquivo em seu computador:
Esse comando deve retornar um valor de soma de verificação.shasum -a 256 fileLocation
- Verifique se o valor da soma de verificação retornada corresponde ao valor SHA-256 fornecido na release do Github. Se os valores não corresponderem, faça download do arquivo novamente e repita este procedimento.
- Abra uma sessão de terminal.
- Execute o seguinte comando, em que
fileLocation
é o caminho completo do arquivo em seu computador:sha256sum fileLocation
Esse comando deve retornar um valor de soma de verificação.
- Verifique se o valor da soma de verificação retornada corresponde ao valor SHA-256 fornecido na release do Github. Se os valores não corresponderem, faça download do arquivo novamente e repita este procedimento.