IBM Cloud Docs
Introdução aos tutoriais de solução

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

  1. Faça download e instale a CLI do IBM Cloud em https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.

  2. Verifique a instalação com:

    ibmcloud version
    

    Pode ser necessário reiniciar sua máquina após a instalação.

Docker

  1. 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.

  2. Se você não tiver uma, inscreva-se para uma conta grátis em https://hub.docker.com/signup.

  3. Faça download e instale o Docker Desktop no Windows em https://docs.docker.com/docker-for-windows/install/.

  4. 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

  1. Faça download de kubectl de https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-windows.
  2. Mova o binário kubectl.exe para o seu PATH.
  3. Verifique a instalação com:
    kubectl version --client=true
    

oc

  1. Faça download da CLI do OpenShift 4.x (oc) mais recente em https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.
  2. Mova o binário oc.exe para o seu PATH.
  3. Verifique a instalação com:
    oc version
    

Helm 3

  1. Faça download do helm em https://github.com/helm/helm/releases/latest.
  2. Descompacte o archive transferido por download.
  3. Mova o binário helm.exe para o seu PATH.
  4. Verifique a instalação com:
    helm version
    

Terraform

  1. Faça download de terraform de https://developer.hashicorp.com/terraform/downloads.
  2. Descompacte o archive transferido por download.
  3. Mova o binário terraform.exe para o seu PATH.
  4. 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

  1. Faça download do jq do https://jqlang.github.io/jq/.
  2. Renomeie jq-win64.exe para jq.exe.
  3. Mova o binário jq.exe para o seu PATH.
  4. Verifique a instalação com:
    jq --version
    

Git

  1. Faça download e instale o git em https://github.com/git-for-windows/git/releases/latest.
  2. 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

  1. Faça download e instale a CLI do IBM Cloud em https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.
  2. Verifique a instalação com:
    ibmcloud version
    

Docker

  1. 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.
  2. Se você não tiver uma, inscreva-se para uma conta grátis em https://hub.docker.com/signup.
  3. Faça download e instale o Docker Desktop no Mac em https://docs.docker.com/docker-for-mac/install/.
  4. Verifique a instalação com:
    docker --version
    docker run hello-world
    

kubectl

  1. Faça download de kubectl de https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-macos.
  2. Torne o binário kubectl executável
    chmod +x ./kubectl
    
  3. Mova o binário para o seu PATH.
    sudo mv ./kubectl /usr/local/bin/kubectl
    
  4. Verifique a instalação com:
    kubectl version --client=true
    

oc

  1. Faça download da CLI do OpenShift 4.x (oc) mais recente em https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.
  2. Extraia openshift-client-mac.tar.gz (Intel) ou openshift-install-mac-arm64.tar.gz (Apple Silicon):
    tar zxvf openshift-client-mac*.tar.gz oc
    
  3. Mova o binário oc para o seu PATH.
    sudo mv ./oc /usr/local/bin/oc
    
  4. Verifique a instalação com:
    oc version
    
    macOS Catalina e mais tarde pode solicitar uma mensagem informando que o desenvolvedor não pode ser verificado Para permitir que oc seja executado de qualquer maneira, execute sudo xattr -r -d com.apple.quarantine /usr/local/bin/oc.

Helm 3

  1. Faça download do helm em https://github.com/helm/helm/releases/latest.
  2. Descompacte o archive transferido por download.
  3. Mova o binário helm para o seu PATH.
    sudo mv ./darwin-amd64/helm /usr/local/bin/helm
    
  4. Verifique a instalação com:
    helm version
    
    macOS Catalina e mais tarde pode solicitar uma mensagem informando que o desenvolvedor não pode ser verificado Para permitir que helm seja executado de qualquer maneira, execute sudo xattr -r -d com.apple.quarantine /usr/local/bin/helm.

Terraform

  1. Faça download de terraform de https://developer.hashicorp.com/terraform/downloads.
  2. Descompacte o archive transferido por download.
  3. Mova o binário terraform para o seu PATH.
    sudo mv ./terraform /usr/local/bin/terraform
    
  4. 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

  1. Faça download de jq de https://jqlang.github.io/jq/.
  2. Renomeie o arquivo transferido por download para jq.
  3. Torne o binário jq executável
    chmod +x ./jq
    
  4. Mova o binário jq para o seu PATH.
    sudo mv ./jq /usr/local/bin/jq
    
  5. Verifique a instalação com:
    jq --version
    
    macOS Catalina e mais tarde pode solicitar uma mensagem informando que o desenvolvedor não pode ser verificado Para permitir que jq seja executado de qualquer maneira, execute sudo xattr -r -d com.apple.quarantine /usr/local/bin/jq.

Git

  1. Verifique se o git está instalado:
    git --version
    
    O macOS pode solicitar que você instale as ferramentas do desenvolvedor. Essas ferramentas incluem a linha de comandos do 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

  1. Faça download e instale a CLI do IBM Cloud em https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.
  2. Verifique a instalação com:
    ibmcloud version
    

Docker

  1. Se você não tiver uma, inscreva-se para uma conta grátis em https://hub.docker.com/signup.
  2. Instale Docker Engine no Ubuntu seguindo as instruções de https://docs.docker.com/engine/install/ubuntu/.
  3. Verifique a instalação com:
    docker --version
    sudo docker run hello-world
    
    Para executar o Docker em seu próprio usuário em vez de raiz, execute as etapas pós-instalação.

kubectl

  1. Faça download de kubectl de https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-linux.
  2. Torne o binário kubectl executável
    chmod +x ./kubectl
    
  3. Mova o binário para o seu PATH.
    sudo mv ./kubectl /usr/local/bin/kubectl
    
  4. Verifique a instalação com:
    kubectl version --client=true
    

oc

  1. Faça download da CLI do OpenShift 4.x (oc) mais recente em https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.
  2. Extraia openshift-client-linux.tar.gz:
    tar zxvf openshift-client-linux.tar.gz oc
    
  3. Mova o binário oc para o seu PATH.
    sudo mv ./oc /usr/local/bin/oc
    
  4. Verifique a instalação com:
    oc version
    

Helm 3

  1. Faça download do helm em https://github.com/helm/helm/releases/latest.
  2. Descompacte o archive transferido por download.
  3. Mova o binário helm para o seu PATH.
    sudo mv ./linux-amd64/helm /usr/local/bin/helm
    
  4. Verifique a instalação com:
    helm version
    

Terraform

  1. Faça download de terraform de https://developer.hashicorp.com/terraform/downloads.
  2. Descompacte o archive transferido por download.
  3. Mova o binário terraform para o seu PATH.
    sudo mv ./terraform /usr/local/bin/terraform
    
  4. 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

  1. Instale o jq com:
    sudo apt install jq
    
  2. Verifique a instalação com:
    jq --version
    

Git

  1. Instale o git com:
    sudo apt install git
    
  2. 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.

  1. Instale os plug-ins a seguir:
    ibmcloud 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
    
    Para ver todos os plug-ins disponíveis, execute ibmcloud plugin repo-plugins e instale um plug-in ibmcloud plugin install <PLUGIN_NAME>

Conta do GitHub

  1. Inscreva-se para uma conta gratuita em https://github.com/.
  2. 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.

  1. Use estas instruções para gerar um novo par de chaves SSH se você não tiver um.
  2. 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:

  1. Crie um novo projeto privado no GitLab e selecione a opção para inicializar o repositório com um LEIA-ME.
  2. Efetue check-out do projeto na linha de comandos clonando com o link do SSH.
  3. Atualize o arquivo LEIA-ME.
  4. 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:

  1. Faça download da CLI estável do OpenShift 4.x (oc) mais recente
    curl https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/openshift-client-linux.tar.gz --output oc.tar.gz
    
  2. Extraia oc.tar.gz:
    tar zxvf oc.tar.gz oc
    
  3. Inclua seu diretório atual em PATH
    export PATH=$PWD:$PATH
    
  4. Verifique a instalação com:
    oc version