Introdução aos tutoriais de solução
Os tutoriais de solução fornecem instruções passo a passo sobre como usar a IBM Cloud para implementar padrões comuns com base em melhores práticas e em tecnologias comprovadas.
Antes de percorrer a coleção de tutoriais, este guia irá ajudá-lo a configurar seu ambiente de desenvolvimento para seguir com sucesso as instruções dos guias localizados nesta coleção.
Objetivos
Instale as ferramentas obrigatórias para ter produtividade no uso do IBM Cloud:
- CLI do IBM Cloud - a interface da linha de comandos para interagir com a API do IBM Cloud.
- Docker - entregar e executar softwares em pacotes chamados contêineres.
- kubectl - uma interface de linha de comandos para executar comandos com relação aos clusters Kubernetes.
- oc - gerencia os aplicativos OpenShift e fornece ferramentas para interagir com cada componente de seu sistema.
- Helm 3 - ajuda a gerenciar aplicativos Kubernetes; os gráficos do Helm ajudam a definir, instalar e fazer upgrade até mesmo dos aplicativos Kubernetes mais complexos.
- Terraform - automatiza o seu fornecimento de recursos.
- jq - um processador JSON de linha de comandos leve e flexível.
- Git - um sistema de controle de versão distribuído de software livre.
Para evitar a instalação dessas ferramentas, também é possível usar o Cloud Shell no console da IBM Cloud.
Microsoft Windows
As seções a seguir supõem que você esteja executando o Microsoft Windows 10 de 64 bits sob um usuário com privilégios de Administrador. Após ter concluído as seções específicas, continue com a configuração comum a todos os sistemas operacionais.
CLI da IBM Cloud
-
Faça download e instale a CLI do IBM Cloud em https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.
-
Verifique a instalação com:
ibmcloud version
Pode ser necessário reiniciar sua máquina após a instalação.
Docker
-
Docker Desktop no Windows é uma opção para executar imagens do contêiner no Windows. Assegure-se de revisar os termos do contrato de licença antes de prosseguir com a instalação.
-
Se você não tiver uma, inscreva-se para uma conta grátis em https://hub.docker.com/signup.
-
Faça download e instale o Docker Desktop no Windows em https://docs.docker.com/docker-for-windows/install/.
-
Verifique a instalação com:
docker --version docker run hello-world
Pode ser necessário efetuar logout e aguardar que o daemon do Docker seja iniciado.
kubectl
- Faça download de
kubectl
de https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-windows. - Mova o binário
kubectl.exe
para o seu PATH. - Verifique a instalação com:
kubectl version --client=true
oc
- Faça download da CLI do OpenShift 4.x (
oc
) mais recente em https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/. - Mova o binário
oc.exe
para o seu PATH. - Verifique a instalação com:
oc version
Helm 3
- Faça download do
helm
em https://github.com/helm/helm/releases/latest. - Descompacte o archive transferido por download.
- Mova o binário
helm.exe
para o seu PATH. - Verifique a instalação com:
helm version
Terraform
- Faça download de
terraform
de https://developer.hashicorp.com/terraform/downloads. - Descompacte o archive transferido por download.
- Mova o binário
terraform.exe
para o seu PATH. - Verifique a instalação com:
terraform version
Para gerenciar os recursos do IBM Cloud com o Terraform, também é necessário instalar o IBM Cloud Provider. Iniciando com o Terraform 0.13, o provedor pode ser transferido por download automaticamente do registro de plug-in do Terraform. Siga
as instruções na documentação do provedor para configurar a propriedade required_providers
em seus modelos
do Terraform.
jq
- Faça download do jq do https://jqlang.github.io/jq/.
- Renomeie
jq-win64.exe
parajq.exe
. - Mova o binário
jq.exe
para o seu PATH. - Verifique a instalação com:
jq --version
Git
- Faça download e instale o
git
em https://github.com/git-for-windows/git/releases/latest. - Verifique a instalação com:
git --version
Continue com a configuração comum a todos os sistemas operacionais.
Apple macOS
As seções a seguir supõem que você esteja executando o macOS High Sierra ou mais recente sob um usuário com privilégios de Administrador. Após ter concluído as seções específicas, continue com a configuração comum a todos os sistemas operacionais.
CLI da IBM Cloud
- Faça download e instale a CLI do IBM Cloud em https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.
- Verifique a instalação com:
ibmcloud version
Docker
- Docker Desktop no Mac é uma opção para executar imagens doe contêiner no macOS. Assegure-se de revisar os termos do contrato de licença antes de prosseguir com a instalação. Outras opções incluem Podman.
- Se você não tiver uma, inscreva-se para uma conta grátis em https://hub.docker.com/signup.
- Faça download e instale o Docker Desktop no Mac em https://docs.docker.com/docker-for-mac/install/.
- Verifique a instalação com:
docker --version docker run hello-world
kubectl
- Faça download de
kubectl
de https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-macos. - Torne o binário
kubectl
executávelchmod +x ./kubectl
- Mova o binário para o seu PATH.
sudo mv ./kubectl /usr/local/bin/kubectl
- Verifique a instalação com:
kubectl version --client=true
oc
- Faça download da CLI do OpenShift 4.x (
oc
) mais recente em https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/. - Extraia
openshift-client-mac.tar.gz
(Intel) ouopenshift-install-mac-arm64.tar.gz
(Apple Silicon):tar zxvf openshift-client-mac*.tar.gz oc
- Mova o binário
oc
para o seu PATH.sudo mv ./oc /usr/local/bin/oc
- Verifique a instalação com:
macOS Catalina e mais tarde pode solicitar uma mensagem informando que o desenvolvedor não pode ser verificado Para permitir queoc version
oc
seja executado de qualquer maneira, executesudo xattr -r -d com.apple.quarantine /usr/local/bin/oc
.
Helm 3
- Faça download do
helm
em https://github.com/helm/helm/releases/latest. - Descompacte o archive transferido por download.
- Mova o binário
helm
para o seu PATH.sudo mv ./darwin-amd64/helm /usr/local/bin/helm
- Verifique a instalação com:
macOS Catalina e mais tarde pode solicitar uma mensagem informando que o desenvolvedor não pode ser verificado Para permitir quehelm version
helm
seja executado de qualquer maneira, executesudo xattr -r -d com.apple.quarantine /usr/local/bin/helm
.
Terraform
- Faça download de
terraform
de https://developer.hashicorp.com/terraform/downloads. - Descompacte o archive transferido por download.
- Mova o binário
terraform
para o seu PATH.sudo mv ./terraform /usr/local/bin/terraform
- Verifique a instalação com:
terraform version
Para gerenciar os recursos do IBM Cloud com o Terraform, também é necessário instalar o IBM Cloud Provider. Iniciando com o Terraform 0.13, o provedor pode ser transferido por download automaticamente do registro de plug-in do Terraform. Siga
as instruções na documentação do provedor para configurar a propriedade required_providers
em seus modelos
do Terraform.
jq
- Faça download de
jq
de https://jqlang.github.io/jq/. - Renomeie o arquivo transferido por download para
jq
. - Torne o binário
jq
executávelchmod +x ./jq
- Mova o binário
jq
para o seu PATH.sudo mv ./jq /usr/local/bin/jq
- Verifique a instalação com:
macOS Catalina e mais tarde pode solicitar uma mensagem informando que o desenvolvedor não pode ser verificado Para permitir quejq --version
jq
seja executado de qualquer maneira, executesudo xattr -r -d com.apple.quarantine /usr/local/bin/jq
.
Git
- Verifique se o
git
está instalado:
O macOS pode solicitar que você instale as ferramentas do desenvolvedor. Essas ferramentas incluem a linha de comandos dogit --version
git
.
Continue com a configuração comum a todos os sistemas operacionais.
Ubuntu Linux
As seções a seguir supõem que você esteja executando o Ubuntu Linux como um usuário não raiz com acesso a privilégios de administrador. Após ter concluído as seções específicas, continue com a configuração comum a todos os sistemas operacionais. Se você estiver usando o Cloud Shell baseado em Linux, prossiga para a seção sobre Cloud Shell.
CLI da IBM Cloud
- Faça download e instale a CLI do IBM Cloud em https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.
- Verifique a instalação com:
ibmcloud version
Docker
- Se você não tiver uma, inscreva-se para uma conta grátis em https://hub.docker.com/signup.
- Instale Docker Engine no Ubuntu seguindo as instruções de https://docs.docker.com/engine/install/ubuntu/.
- Verifique a instalação com:
Para executar o Docker em seu próprio usuário em vez de raiz, execute as etapas pós-instalação.docker --version sudo docker run hello-world
kubectl
- Faça download de
kubectl
de https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-linux. - Torne o binário
kubectl
executávelchmod +x ./kubectl
- Mova o binário para o seu PATH.
sudo mv ./kubectl /usr/local/bin/kubectl
- Verifique a instalação com:
kubectl version --client=true
oc
- Faça download da CLI do OpenShift 4.x (
oc
) mais recente em https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/. - Extraia
openshift-client-linux.tar.gz
:tar zxvf openshift-client-linux.tar.gz oc
- Mova o binário
oc
para o seu PATH.sudo mv ./oc /usr/local/bin/oc
- Verifique a instalação com:
oc version
Helm 3
- Faça download do
helm
em https://github.com/helm/helm/releases/latest. - Descompacte o archive transferido por download.
- Mova o binário
helm
para o seu PATH.sudo mv ./linux-amd64/helm /usr/local/bin/helm
- Verifique a instalação com:
helm version
Terraform
- Faça download de
terraform
de https://developer.hashicorp.com/terraform/downloads. - Descompacte o archive transferido por download.
- Mova o binário
terraform
para o seu PATH.sudo mv ./terraform /usr/local/bin/terraform
- Verifique a instalação com:
terraform version
Para gerenciar os recursos do IBM Cloud com o Terraform, também é necessário instalar o IBM Cloud Provider. Iniciando com o Terraform 0.13, o provedor pode ser transferido por download automaticamente do registro de plug-in do Terraform. Siga
as instruções na documentação do provedor para configurar a propriedade required_providers
em seus modelos
do Terraform.
jq
- Instale o
jq
com:sudo apt install jq
- Verifique a instalação com:
jq --version
Git
- Instale o
git
com:sudo apt install git
- Verifique a instalação com:
git --version
Continue com a configuração comum a todos os sistemas operacionais.
Comum a todos os sistemas operacionais
As próximas seções são comuns a todos os sistemas operacionais.
Plug-ins da CLI do IBM Cloud
Os plug-ins estendem os recursos da CLI do IBM Cloud com comandos específicos para um serviço.
- Instale os plug-ins a seguir:
Para ver todos os plug-ins disponíveis, executeibmcloud plugin install container-registry ibmcloud plugin install cloud-object-storage ibmcloud plugin install kubernetes-service ibmcloud plugin install vpc-infrastructure ibmcloud plugin install code-engine
ibmcloud plugin repo-plugins
e instale um plug-inibmcloud plugin install <PLUGIN_NAME>
Conta do GitHub
- Inscreva-se para uma conta gratuita em https://github.com/.
- Crie um novo repositório público em https://github.com/new para familiarizar-se com o GitHub.
IBM Cloud GitLab
O IBM Cloud fornece repositórios Git hospedados que são construídos no GitLab Community Edition e estão acessíveis com as mesmas credenciais usadas para efetuar login no IBM Cloud. Recomenda-se configurar sua chave pública SSH para simplificar as interações da linha de comandos com os repositórios Git.
- Use estas instruções para gerar um novo par de chaves SSH se você não tiver um.
- Inclua sua chave pública SSH em suas definições de Git na região na qual você planeja hospedar seus repositórios Git, como Dallas(us-south.git.cloud.ibm.com), London(eu-gb.git.cloud.ibm.com) ou Frankfurt(eu-de.git.cloud.ibm.com)..
Para verificar a configuração:
- Crie um novo projeto privado no GitLab e selecione a opção para inicializar o repositório com um LEIA-ME.
- Efetue check-out do projeto na linha de comandos clonando com o link do SSH.
- Atualize o arquivo LEIA-ME.
- Confirme e envie por push as mudanças.
Cloud Shell
oc
Siga estas etapas se for necessário usar outra versão da CLI do OpenShift diferente da pré-instalada:
- Faça download da CLI estável do OpenShift 4.x (
oc
) mais recentecurl https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/openshift-client-linux.tar.gz --output oc.tar.gz
- Extraia
oc.tar.gz
:tar zxvf oc.tar.gz oc
- Inclua seu diretório atual em
PATH
export PATH=$PWD:$PATH
- Verifique a instalação com:
oc version