Início
Pré-requisitos
Instalando a CLI
Configuração básica e login
Arquivo de configuração
Projetos
O que mais?
Início
A CLI do OpenShift tem comandos para gerenciar suas aplicações, como também um conjunto de ferramentas para interagir com cada componente do seu sistema. Este artigo vai guiar você através da instalação, login e criação do seu primeiro projeto.
Pré-requisitos
Alguns passos desse artigo requerem que você tenha o Git instalado no seu ambiente. Por exemplo, o comando para criar uma aplicação usando um repositório remoto:
$ oc new-app https://github.com/seu_usuario/<seu_repositorio>
Antes de continuar, instale o Git no seu sistema. Veja a documentação do Git para instruções de como instalar em seu sistema operacional.
Instalando a CLI
A instalação da CLI pode variar dependendo do seu sistema operacional. Siga as instruções abaixo para instalar a CLI de acordo com o seu sistema operacional.
Windows
Você pode fazer o download do executável compactado para Windows através da página Releases do repositório OpenShift Origin no GitHub.
Descompacte o arquivo e mova para o diretório C:\Windows\System32
Mac OS X
Você pode fazer o download do binário compactado para Mac OS X através da página Releases do repositório OpenShift Origin no GitHub.
Descompacte o arquivo em um diretório no seu PATH.
Alternativamente, usuários do Mac OS X podem instalar a CLI usando Homebrew:
$ brew install openshift-cli
Linux
Você pode fazer o download do binário compactado para Linux através da página Releases do repositório OpenShift Origin no GitHub.
Descompacte o arquivo em um diretório no seu PATH.
$ tar -xf file
Configuração básica e login
O comando oc login é o melhor caminho para iniciar a configuração do OpenShift CLI, é o ponto de partida da maioria dos usuários. O processo de login é bem interativo e ajuda você a estabelecer uma conexão ao servidor com as credenciais fornecidas no login. As informações são salvas automaticamente em um arquivo de configuração que é usado para os comandos subsequentes.
A seguir alguns exemplos mostram a configuração e login interativos através do comando oc login:
Exemplo 1. Configuração Inicial da CLI
$ oc login
OpenShift server [https://localhost:8443]: https://api.getupcloud.com
Username: vander@getupcloud.com
Authentication required for https://portal.getupcloud.com:443 (openshift)
Password: ******
Login successful.
You don't have any projects. You can try to create a new project, by running
$ oc new-project <projectname>
Welcome to OpenShift! See 'oc help' to get started.
O comando pergunta pela URL do servidor OpenShift da Getup.
O comando pergunta pelas credenciais: o usuário (e-mail) e senha.
Uma sessão foi estabelecida com o servidor, e um token de sessão é recebido.
Se você não tiver um projeto, vai receber a instrução de como criar um.
Quando você tiver completado a configuração da CLI, comandos subsequentes irão usar o arquivo de configuração da CLI para o servidor, token de sessão e informações de projetos.
Você pode fazer logout da CLI usando o comando oc logout:
$ oc logout
User, vander, logged out of https://portal.getupcloud.com:443
Se você logar depois de criar ou ser adicionado a um projeto, o projeto que você tem acesso é automaticamente setado como default, a menos que você troque para outro.
$ oc login
Username: vander
Authentication required for https://portal.getupcloud.com:443 (openshift)
Password:
Login successful.
Using project "vanderproject".
Outras opções estão disponíveis para o comando oc login.
Arquivo de Configuração
O arquivo de configuração da CLI armazena opções do comando oc e contem uma serie de mecanismos de autenticação e informações de conexão relacionada com os usuários do OpenShift.
Como falado anteriormente, o comando oc login cria automaticamente e gerencia os arquivos de configuração da CLI. Todas as informações conseguidas pelo comando são armazenadas no arquivo de configuração em ~/.kube/config. A configuração da CLI pode ser visualizada através do seguinte comando:
Exemplo 2. Visualizando a configuração da CLI
$ oc config view
apiVersion: v1
clusters:
- cluster:
server: https://portal.getupcloud.com:443
name: portal-getup-cloud-com:443
contexts:
- context:
cluster: portal-getup-cloud-com:443
namespace: vanderproject
user: vander/portal-getupcloud-com:443
name: vanderproject/portal-getupcloud-com:443/vander
current-context: vander/portal-getupcloud-com:443/vander
kind: Config
preferences: {}
users:
- name: vander
user:
token: NDM2N2MwODgtNjI1Yy10N3VhLTg1YmItYzI4NDEzZDUyYzVi
Arquivos de configuração da CLI podem ser usados para configurar múltiplos perfis usando diversos servidores OpenShift, namespaces e usuários, assim você pode trocar entre eles facilmente. A CLI suporta múltiplos arquivos de configuração; eles são carregados na execução e mesclados com qualquer opção especificada na linha de comando.
Projetos
Um projeto do OpenShift contem múltiplos objetos que criam uma aplicação lógica.
A maioria das opções do comando oc rodam no contexto de um projeto. O comando oc login seleciona o projeto default durante a configuração inicial para ser usado com os comandos subsequentes. O seguinte comando é utilizado para exibir o projeto em uso:
$ oc project
Se você tem acesso a múltiplos projetos, use a seguinte opção para trocar de projeto especificando o nome do projeto ao comando oc:
$ oc project <nome_projeto>
Exemplo:
$ oc project project02
Now using project 'project02'.
$ oc project project03
Now using project 'project03'.
$ oc project
Now using project 'project03'.
O comando oc status exibe um nível detalhado de informações do projeto em uso, com os seus componentes e as suas relações, conforme mostrado no exemplo a seguir:
$ oc status
In project OpenShift 3 Sample (test)
service database-test (172.30.17.113:6434 -> 3306)
database-test deploys docker.io/library/mysql:latest
#1 deployed 47 hours ago
service frontend-test (172.30.17.236:5432 -> 8080)
frontend-test deploys origin-ruby-sample:test <-
builds git://github.com/openshift/ruby-hello-world.git with docker.io/openshift/ruby-20-centos7:latest
not built yet
#1 deployment waiting on image
To see more information about a service or deployment config, use 'oc describe service <name>' or 'oc describe dc <name>'.
You can use 'oc get pods,svc,dc,bc,builds' to see lists of each of the types described above.
O que mais?
Depois que você fez o login, você pode criar uma nova aplicação e descobrir algumas opções da CLI.
Comentários
0 comentário
Por favor, entre para comentar.