Iniciación a las guías de aprendizaje de soluciones

Las guías de aprendizaje de soluciones ofrecen instrucciones paso a paso sobre cómo utilizar IBM Cloud para implementar patrones comunes basados en prácticas recomendadas y tecnologías probadas.

Antes de adentrarnos en la colección de las guías de aprendizaje, esta guía le ayudará a configurar el entorno de desarrollo para seguir correctamente las instrucciones de las guías disponibles en esta recopilación.

Objetivos

Herramientas imprescindibles para la instalación para que IBM Cloud sea productivo:

  • CLI de IBM Cloud: la interfaz de línea de mandatos para interactuar con la API de IBM Cloud.
  • Docker: para entregar y ejecutar software en paquetes llamados contenedores.
  • kubectl: una interfaz de línea de mandatos para ejecutar mandatos en clústeres Kubernetes.
  • oc: gestiona las aplicaciones de OpenShift y proporciona herramientas para interactuar con cada componente del sistema.
  • Helm 3: le ayuda a gestionar aplicaciones Kubernetes; los diagramas de Helm ayudan a definir, instalar y actualizar incluso la aplicación Kubernetes más compleja.
  • Terraform: automatiza el suministro de recursos.
  • jq: un procesador JSON de línea de mandatos ligero y flexible.
  • Git: un sistema de control de versiones distribuido de código abierto y gratuito.

Para evitar tener que instalar estas herramientas, también puede utilizar Cloud Shell desde la consola de IBM Cloud.

Microsoft Windows

En las secciones siguientes, se presupone que está ejecutando Microsoft Windows 10 de 64 bits con un usuario con privilegios de administrador. Una vez que haya terminado con las secciones específicas, continúe con la configuración común de todos los sistemas operativos.

IBM Cloud CLI

  1. Descargue e instale la CLI de IBM Cloud desde https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.

  2. Verifique la instalación con:

    ibmcloud version

    Es posible que necesite reiniciar la máquina tras la instalación.

Docker

  1. Docker Desktop en Windows es una opción para ejecutar imágenes de contenedor en Windows. Asegúrese de revisar los términos del acuerdo de licencia antes de continuar con la instalación.

  2. Si no tiene cuenta, registre una cuenta gratuita en https://hub.docker.com/signup.

  3. Descargue e instale Docker Desktop en Windows desde https://docs.docker.com/docker-for-windows/install/.

  4. Verifique la instalación con:

    docker --version
docker run hello-world

    Es posible que tenga que finalizar la sesión y esperar a que se inicie el daemon de Docker.

kubectl

  1. Descargue kubectl desde https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-windows.
  2. Mueva el binario de kubectl.exe a la variable PATH.
  3. Verifique la instalación con:
    kubectl version --client=true

oc

  1. Descargue la última CLI de 4.x OpenShift (oc) de https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.
  2. Mueva el binario de oc.exe a la variable PATH.
  3. Verifique la instalación con:
    oc version

Helm 3

  1. Descargue helm desde https://github.com/helm/helm/releases/latest.
  2. Descomprima el archivo descargado.
  3. Mueva el binario de helm.exe a la variable PATH.
  4. Verifique la instalación con:
    helm version

Terraform

  1. Descargue terraform desde https://developer.hashicorp.com/terraform/downloads.
  2. Descomprima el archivo descargado.
  3. Mueva el binario de terraform.exe a la variable PATH.
  4. Verifique la instalación con:
    terraform version

Para gestionar los recursos de IBM Cloud con Terraform, también es necesario instalar el proveedor de IBM Cloud. A partir de la versión 0.13 de Terraform, el proveedor se puede descargar automáticamente desde el registro de plugins de Terraform. Siga las instrucciones de la documentación del proveedor para configurar la propiedad required_providers en las plantillas de Terraform.

jq

  1. Descargue jq desde https://jqlang.github.io/jq/.
  2. Cambie el nombre de jq-win64.exe a jq.exe.
  3. Mueva el binario de jq.exe a la variable PATH.
  4. Verifique la instalación con:
    jq --version

Git

  1. Descargue e instale git desde https://github.com/git-for-windows/git/releases/latest.
  2. Verifique la instalación con:
    git --version

Continúe con la configuración común de todos los sistemas operativos.

Apple macOS

En las secciones siguientes, se presupone que está ejecutando macOS High Sierra o posterior con un usuario con privilegios de administrador. Una vez que haya terminado con las secciones específicas, continúe con la configuración común de todos los sistemas operativos.

IBM Cloud CLI

  1. Descargue e instale la CLI de IBM Cloud desde https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.
  2. Verifique la instalación con:
    ibmcloud version

Docker

  1. Docker Desktop en Mac es una opción para ejecutar imágenes de contenedor en macOS. Asegúrese de revisar los términos del acuerdo de licencia antes de continuar con la instalación. Otras opciones incluyen Podman.
  2. Si no tiene cuenta, registre una cuenta gratuita en https://hub.docker.com/signup.
  3. Descargue e instale Docker Desktop en Mac desde https://docs.docker.com/docker-for-mac/install/.
  4. Verifique la instalación con:
    docker --version
docker run hello-world

kubectl

  1. Descargue kubectl de https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-macos.
  2. Convierta el binario kubectl en ejecutable.
    chmod +x ./kubectl
  3. Mueva el binario a la variable PATH.
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. Verifique la instalación con:
    kubectl version --client=true

oc

  1. Descargue la última CLI de 4.x OpenShift (oc) de https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.
  2. Extraiga openshift-client-mac.tar.gz (Intel) o openshift-install-mac-arm64.tar.gz (Apple Silicon):
    tar zxvf openshift-client-mac*.tar.gz oc
  3. Mueva el binario de oc a la variable PATH.
    sudo mv ./oc /usr/local/bin/oc
  4. Verifique la instalación con:
    oc version
    macOS Catalina y posteriores pueden solicitarle un mensaje que indique que el desarrollador no se puede verificar. Para permitir que oc se ejecute de todos modos, ejecute sudo xattr -r -d com.apple.quarantine /usr/local/bin/oc.

Helm 3

  1. Descargue helm desde https://github.com/helm/helm/releases/latest.
  2. Descomprima el archivo descargado.
  3. Mueva el binario de helm a la variable PATH.
    sudo mv ./darwin-amd64/helm /usr/local/bin/helm
  4. Verifique la instalación con:
    helm version
    macOS Catalina y posteriores pueden solicitarle un mensaje que indique que el desarrollador no se puede verificar. Para permitir que helm se ejecute de todos modos, ejecute sudo xattr -r -d com.apple.quarantine /usr/local/bin/helm.

Terraform

  1. Descargue terraform desde https://developer.hashicorp.com/terraform/downloads.
  2. Descomprima el archivo descargado.
  3. Mueva el binario de terraform a la variable PATH.
    sudo mv ./terraform /usr/local/bin/terraform
  4. Verifique la instalación con:
    terraform version

Para gestionar los recursos de IBM Cloud con Terraform, también es necesario instalar el proveedor de IBM Cloud. A partir de la versión 0.13 de Terraform, el proveedor se puede descargar automáticamente desde el registro de plugins de Terraform. Siga las instrucciones de la documentación del proveedor para configurar la propiedad required_providers en las plantillas de Terraform.

jq

  1. Descargue jq desde https://jqlang.github.io/jq/.
  2. Cambie el nombre del archivo descargado a jq.
  3. Convierta el binario jq en ejecutable.
    chmod +x ./jq
  4. Mueva el binario de jq a la variable PATH.
    sudo mv ./jq /usr/local/bin/jq
  5. Verifique la instalación con:
    jq --version
    macOS Catalina y posteriores pueden solicitarle un mensaje que indique que el desarrollador no se puede verificar. Para permitir que jq se ejecute de todos modos, ejecute sudo xattr -r -d com.apple.quarantine /usr/local/bin/jq.

Git

  1. Compruebe que git esté instalado:
    git --version
    macOS puede solicitarle que instale las herramientas del desarrollador. Estas herramientas incluyen la línea de mandatos git.

Continúe con la configuración común de todos los sistemas operativos.

Ubuntu Linux

En las secciones siguientes se presupone que está ejecutando Ubuntu Linux como usuario no root con acceso a los privilegios de root. Una vez que haya terminado con las secciones específicas, continúe con la configuración común de todos los sistemas operativos. Si está utilizando Cloud Shell basado en Linux, continúe con la sección de Cloud Shell.

IBM Cloud CLI

  1. Descargue e instale la CLI de IBM Cloud desde https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest.
  2. Verifique la instalación con:
    ibmcloud version

Docker

  1. Si no tiene cuenta, registre una cuenta gratuita en https://hub.docker.com/signup.
  2. Instale Docker Engine en Ubuntu siguiendo las instrucciones de https://docs.docker.com/engine/install/ubuntu/.
  3. Verifique la instalación con:
    docker --version
sudo docker run hello-world
    Para ejecutar Docker con su propio usuario en lugar de root, realice los pasos posteriores a la instalación.

kubectl

  1. Descargue kubectl desde https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-linux.
  2. Convierta el binario kubectl en ejecutable.
    chmod +x ./kubectl
  3. Mueva el binario a la variable PATH.
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. Verifique la instalación con:
    kubectl version --client=true

oc

  1. Descargue la última CLI de 4.x OpenShift (oc) de https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/.
  2. Extraiga openshift-client-linux.tar.gz:
    tar zxvf openshift-client-linux.tar.gz oc
  3. Mueva el binario de oc a la variable PATH.
    sudo mv ./oc /usr/local/bin/oc
  4. Verifique la instalación con:
    oc version

Helm 3

  1. Descargue helm desde https://github.com/helm/helm/releases/latest.
  2. Descomprima el archivo descargado.
  3. Mueva el binario de helm a la variable PATH.
    sudo mv ./linux-amd64/helm /usr/local/bin/helm
  4. Verifique la instalación con:
    helm version

Terraform

  1. Descargue terraform desde https://developer.hashicorp.com/terraform/downloads.
  2. Descomprima el archivo descargado.
  3. Mueva el binario de terraform a la variable PATH.
    sudo mv ./terraform /usr/local/bin/terraform
  4. Verifique la instalación con:
    terraform version

Para gestionar los recursos de IBM Cloud con Terraform, también es necesario instalar el proveedor de IBM Cloud. A partir de la versión 0.13 de Terraform, el proveedor se puede descargar automáticamente desde el registro de plugins de Terraform. Siga las instrucciones de la documentación del proveedor para configurar la propiedad required_providers en las plantillas de Terraform.

jq

  1. Instale jq con:
    sudo apt install jq
  2. Verifique la instalación con:
    jq --version

Git

  1. Instale git con:
    sudo apt install git
  2. Verifique la instalación con:
    git --version

Continúe con la configuración común de todos los sistemas operativos.

Común a todos los sistemas operativos

Las siguientes secciones son comunes a todos los sistemas operativos.

Plugins de CLI de IBM Cloud

Los plugins amplían las funciones de la CLI de IBM Cloud con mandatos específicos de un servicio.

  1. Instale los siguientes plugins:
    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 los plugins disponibles, ejecute ibmcloud plugin repo-plugins y para instalar un plugin ibmcloud plugin install <PLUGIN_NAME>

Cuenta de GitHub

  1. Regístrese para obtener una cuenta gratuita en https://github.com/.
  2. Cree un nuevo repositorio público en https://github.com/new para familiarizarse con GitHub.

IBM Cloud GitLab

IBM Cloud le proporciona repositorios Git alojados creados en GitLab Community Edition y a los que se puede acceder con las mismas credenciales utilizadas para iniciar sesión en IBM Cloud. Se recomienda configurar la clave pública SSH para simplificar las interacciones de línea de mandatos con los repositorios Git.

  1. Utilice estas instrucciones para generar un nuevo par de claves SSH si no tiene uno.
  2. Añada la clave pública SSH a los valores de Git en la región donde tiene previsto alojar los repositorios Git, como por ejemplo Dallas(us-south.git.cloud.ibm.com), Londres(eu-gb.git.cloud.ibm.com) o Frankfurt(eu-de.git.cloud.ibm.com).

Para verificar la configuración:

  1. Cree un nuevo proyecto privado en GitLab, seleccione la opción para inicializar el repositorio con un README.
  2. Extraiga el proyecto desde la línea de mandatos clonando con el enlace SSH.
  3. Actualice el archivo README.
  4. Confirme los cambios y envíelos por push.

Cloud Shell

oc

Siga estos pasos si tiene que utilizar otra versión de la CLI de OpenShift distinta a la que viene preinstalada:

  1. Descargue la última CLI estable de 4.x OpenShift (oc)
    curl https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/openshift-client-linux.tar.gz --output oc.tar.gz
  2. Extraiga oc.tar.gz:
    tar zxvf oc.tar.gz oc
  3. Alada el directorio actual en PATH
    export PATH=$PWD:$PATH
  4. Verifique la instalación con:
    oc version