Configurar su estación de trabajo macOS como entorno de desarrollo

Objetivos

1. Instale un conjunto de herramientas de desarrollo básico en su estación de trabajo local

2. Verifique que todas las herramientas funcionen según lo esperado

Pre-requisitos
En esta guía encontrará tutoriales sobre cómo instalar un conjunto de herramientas de desarrollo comunes en una estación de trabajo de macOS. Si aún no ha revisado el
laboratorio "¿Qué es un entorno de desarrollo y por qué lo necesita? ", es posible que desee volver y echar un vistazo. En él aprenderá las razones detrás de los tipos de
herramientas y opciones tomadas para este laboratorio.

Privilegios de administrador
Para completar esta guía, necesitará privilegios para instalar el software en su estación de trabajo, generalmente llamados "privilegios de administrador". Si está trabajando
desde una "computadora portátil administrada" y no tiene la capacidad de instalar software, no podrá completar esta guía. Nota: Las instrucciones en esta guía fueron
diseñadas y probadas en una compilación limpia de macOS Sierra o High Sierra. Si está trabajando desde una versión diferente de macOS, o tiene otras aplicaciones
instaladas en su estación de trabajo, la experiencia exacta y los mensajes pueden ser diferentes. Siempre se sugiere consultar las guías oficiales de instalación y
configuración de las aplicaciones de software para cualquier pregunta o aclaración.

Paso 1: preparación de macOS

Lo que desea es completar la preparación específica para un entorno de desarrollo basado en Mac, para poder ejecutar la mayoría de los comandos en el sistema Learning
Labs. Empecemos.

Instalar Homebrew

Homebrew es una aplicación de gestión de paquetes para macOS similar a yum en Enterprise Linux y apt para distribuciones de Linux basadas en Debian. Al usar Homebrew,
puede simplificar enormemente la instalación y administración de aplicaciones en su estación de trabajo macOS, así como obtener acceso rápido a muchas utilidades
estándar de Linux que no están incluidas en macOS por defecto. Más información en brew.sh. Usamos la mayor parte de esas instrucciones de instalación aquí.

Como requisito previo, también nos aseguramos de que las herramientas para desarrolladores XCode estén instaladas en estas instrucciones. Cuando tiene instaladas las
herramientas de línea de comandos de XCode Developer, también obtiene git , la herramienta de control de versiones. 1. Abra la aplicación Terminal para acceder al shell
bash nativo en macOS. 2. Asegúrese de que las herramientas XCode Developer estén instaladas: xcode-select --install Este comando abre un cuadro de diálogo de
instalación si es necesario, o si ya está instalado, verá: xcode-select: error: las herramientas de línea de comandos ya están instaladas, use
"Actualización de software" para instalar las actualizaciones en la ventana de su terminal. Complete la instalación de XCode, si es necesario 3. Ejecute el
comando de instalación Homebrew desde el terminal: /usr/bin/ruby ​​-e "$(curl -fsSL
https://raw.githubusercontent.com/Homebrew/install/master/install)" Ejemplo de salida que debería ver en la terminal:

# Salida final de muestra

==> ¡Instalación exitosa!

==> Homebrew ha habilitado el análisis anónimo del comportamiento del usuario agregado.
Lea la documentación analítica (y cómo darse de baja) aquí:
https://docs.brew.sh/Analytics.html

==> Siguientes pasos:

- Ejecute `brew help` para comenzar
- Documentación adicional:
https://docs.brew.sh

4. Verifique la instalación exitosa verificando la versión: brew -v Verá esta salida, con su número de versión, como se muestra:

# Salida de muestra
Homebrew 2.2.2
Homebrew / homebrew-core (git revisión 7ac88; última confirmación 2020-01-02)
Homebrew / homebrew-cask (revisión git 8f0543; última confirmación 2020-01-02)

5. Homebrew proporciona acceso a muchas aplicaciones y paquetes estándar, pero no está optimizado para grandes aplicaciones basadas en binarios. Como una
extensión para brew , está disponible cask . Para verificar que Cask esté instalado y funcionando, ingrese a la terminal: brew cask list

Paso 2: Sistemas de control de versiones

Es importante tener acceso a los comandos de control de código fuente en su ventana de Terminal, ya que muchos tutoriales para desarrolladores le solicitan ejecutar los
comandos git en lugar de usar una interfaz de usuario. Hay varios sistemas de control de fuente y control de versiones. Git proporciona una herramienta de línea de
comandos para los numerosos sistemas de colaboración basados en navegador para el control de código fuente como GitHub, GitLab y BitBucket.

git

Instalación
En Mac, debe tener comandos git disponibles, porque la instalación de XCode Tools que completó como requisito previo para instalar Homebrew ya instaló git.

Verificación

Verifiquemos que git funciona correctamente: 1. Abra una ventana de Terminal. 2. Desde dentro de la terminal, ejecute: git --version Debería obtener una salida que
indique la versión de git instalada (su versión local puede diferir ligeramente, dependiendo de las actualizaciones).

# Ejemplo de salida
git version 2.15.2

3. Use el siguiente comando para clonar un repositorio de código fuente de muestra de GitHub, de modo que tenga una copia local de los archivos en su PC. No necesita
una cuenta de GitHub para este paso: git clone https://github.com/CiscoDevNet/hello_network Debería ver esta salida, y dado que es un repositorio
pequeño, no debería tomar mucho tiempo:

# Expected Output
Cloning into 'hello_network'...
remote: Counting objects: 11, done.
remote: Compressing objects: 100% (7/7), done.
remote: Total 11 (delta 0), reused 0 (delta 0), pack-reused 11
Unpacking objects: 100% (11/11), done.

Paso 3: Terminales y Shells

Sí, ya ha estado usando la Terminal de su Mac, pero verifiquemos usando el código en el repositorio clonado previamente.

bash

Instalación

El "terminal" predeterminado para macOS es un shell bash. Verifiquemos que esté funcionando correctamente.

Verificación

1. Cambie al directorio hello_network que clonó en el último paso. cd hello_network

2. En el repositorio se incluye un script de shell bash llamado hello_network.sh. Use el comando ls para ver una lista de los contenidos del directorio: ls Debería ver los
siguientes archivos listados:

LICENSE hello_network.py py2-venv

README.md hello_network.sh

3. Ejecute el script hello_network.sh para verificar que funciona su bash shell: ./hello_network.sh Debe ver la siguiente frase en su terminal:

# Salida Esperada
Hello Network!

Paso 4: Python y Node

Instalar Python

Python 3 es la versión recomendada de Python. Mac OS incluye una versión de Python 2 por defecto, pero esta NO es la última versión de Python 2. Nota: Python 2 ya no es
compatible. A partir del 1 de enero de 2020, no se realizarán nuevos informes de errores, correcciones o cambios en Python 2. Puede leer las instrucciones de Python 2 en el
apéndice de este Laboratorio, pero no es obligatorio ni se recomienda. 1. Abra una ventana de Terminal y utilice brew para instalar Python 3.x. Probablemente verá que se
instala el 3.8, pero estos ejemplos muestran la 3.6.5: brew install python Debe ver una salida similar a la siguiente:
 # Ejemplo de salida final
Python ha sido instalado en
/usr/local/bin/python3

Enlaces simbólicos no versionados `python`, `python-config`, `pip` etc. apuntando a

`python3`, `python3-config`, `pip3` etc., respectivamente, han sido instalados en
/usr/local/opt/python/libexec/bin

Si necesita Homebrews Python 2.7 ejecute

brew install python@2

Pip, setuptools, y wheel han sido instalados. Para actualizar, ejecute

pip3 install --upgrade pip setuptools wheel

Puede instalar los paquetes de Python con

pip3 install <paquete>
Se instala en el directorio site-package
/usr/local/lib/python3.6/site-packages

Ver: https://docs.brew.sh/Homebrew-and-Python
==> Summary
(brew) /usr/local/Cellar/python/3.6.9: 4,705 file, 99.5MB

2. Abra una ventana del Terminal.

3. Verifique que Python 3.x se instaló correctamente agregando un 3 al comando python , de la siguiente manera: python3 -v Debe observar la versión:

# Salida Esperada
Python 3.8.3

4. Ahora debe configurar Python 3 como su versión predeterminada de Python. Abra su archivo ~ / .bash_profile en un editor de texto como vim o nano y agregue las
siguientes líneas, que crean alias para usar Python 3 y pip3:

alias pythhon=python3
alias pip=pip3

Nota: Esta es una solución a corto plazo que puede usar para estos laboratorios. Muchos recursos en Internet proporcionan otras soluciones que usan enlaces simbólicos o la
herramienta pyenv. Siéntase libre de investigar más por su cuenta.

Entornos virtuales de Python

Antes de terminar con la configuración de Python, debe saber cómo crear un entorno virtual de Python. Los entornos virtuales de Python son un método para crear "entornos"
aislados donde se pueden instalar versiones específicas de Python junto con conjuntos independientes de bibliotecas y dependencias.

El uso del entorno virtual es muy común y es una práctica recomendada cuando se trabaja en Python, y la mayoría de los laboratorios de DevNet lo alientan a crear y trabajar
en entornos virtuales. 1. Cree un entorno virtual de Python 3 utilizando el siguiente comando: python3.8 -m venv py3-venv 2. Ahora "active" el entorno: source py3-
venv/bin/activate Verifique el símbolo del sistema, que ahora debe mostrar el nombre del entorno virtual, entre paréntesis:

# Salida Esperada
(py3-venv) Esta-MacBook-Pro:hello_network username$

3. Ahora verifique que el comando python ha sido vinculado al binario de Python3 en este entorno: python -V

# Salida Esperadda
Python 3.8.3

4. Desactive el entorno virtual. deactivate

Node

Node.js es un entorno de tiempo de ejecución de JavaScript utilizado para interpretar JavaScript en un servidor (en lugar de en el navegador, donde es posible que haya visto
JavaScript, en el código de la página web). Nota: Si ya tiene Node installado, es necesario correr el siguiente comando: brew upgrade node en lugar de seguir los pasos
mostrados a continuación. 1. Vaya al terminal y utilice brew para instalar Node: brew install node
 # Salida esperada
Esta fórmula es keg-only, lo que significa que no se vinculó en /usr/local,
porque macOS proporciona libicucore.dylib (pero nada más).

Si necesita tener este software primero en su PATH, ejecute:

echo 'export PATH = "/usr/local/opt/icu4c/bin:$PATH"' >> ~/.bash_profile
echo 'export PATH = "/usr/local/opt/icu4c/sbin:$PATH"' >> ~/.bash_profile

Para que los compiladores encuentren este software, es posible que deba configurar:
LDFLAGS: -L /usr/local/opt/icu4c/lib
CPPFLAGS: -I /usr/local/opt/icu4c/include

==> Resumen
(brew) /usr/local/Cellar/icu4c/61.1: 249 archivos, 67,2MB
==> Instalación de nodo
==> Descargando https://homebrew.bintray.com/bottles/node-10.9.0.high_sierra.bottle.tar.gz
################################################## ###################### 100.0%
==> Vertido de nodo-10.9.0.high_sierra.bottle.tar.gz
==> Advertencias
La compleción de Bash se ha instalado en:
/usr/local/etc/bash_completion.d
==> Resumen
(brew) /usr/local/Cellar/node/10.9.0: 5,125 archivos, 49.7MB

2. Abra una ventana de Terminal.

3. Verifique la versión instalada de Node.

node -v
# Salida Esperada
v10.9.0

Paso 5: Editores de Texto y EDI

Un editor de texto / EDI que tenga resaltado de sintaxis de código puede ser una herramienta valiosa en la caja de herramientas de un desarrollador. Dicho esto, como
mencionamos anteriormente en este módulo, a medida que realiza más codificación, es probable que pruebe y use una variedad de editores. Al sugerir Atom y Visual Studio
Code y mostrarle cómo instalarlos, proporcionamos un punto de partida. Un EDI es un entorno de desarrollo integrado, y Atom también puede cumplir este propósito con
paquetes agregados, pero no necesitamos entrar en ese aspecto de Atom para estos laboratorios. Ver ide.atom.io/ para más detalles. Visual Studio Code tiene soporte
incorporado para Node.js, y también le mostraremos cómo instalar la extensión Python para facilitar el desarrollo con ese lenguaje.

Atom

Instalación

1. Vaya a atom.io.
2. Haga click en el botón de Descarga en la página para macOS y guarde el archivo .zip .
3. Haga doble-click en el archivo descargado para extraer el fichero de la aplicación Atom.
4. Arrastre la nueva aplicación 'Atom' a su carpeta de 'Aplicaciones'. Nota: Puede leer las instrucciones detalladas de instalación en el Manual de vuelo de Atom. Si bien
Homebrew también es una excelente solución de instalación, no es oficialmente compatible para instalar Atom.

Verificación

Ingrese atom a la Terminal para abrir la aplicación Atom, o la puede buscar en la carpeta de Aplicaciones.

atom

Visual Studio Code

Instalación

1. Vaya a code.visualstudio.com.
2. El sitio reconoce su sistema operativo y le ofrece el enlace de descarga apropiado.
3. Descargue el instalador, ábralo, y copie VS Code a sus Aplicaciones.
4. Abra VS Code para mostrar la interfaz principal.
5. Abra la Paleta de comandos (F1) y escriba "shell" para encontrar el comando de Shell: Instalar el comando 'code' en el PATH:

6. En la esquina superior izquierda, seleccione la vista Extensiones, busque "python" e instale la primera opción, es decir, la extensión "Python" (de Microsoft).
Verificación

¡Todo listo!

Paso 6: Clientes y Herramientas de Desarrollo

Postman

Postman es una herramienta de prueba única para testear los comandos de REST APIs.

Instalación

1. Abra la terminal y utilice brew cask para instalar Postman.

brew cask install postman

Debe ver la siguiente salida en su ventana de terminal:

==> Satisfaciendo dependencias

==> Descargando https://dl.pstmn.io/download/version/6.0.10/osx64
######################################################################## 100.0%
==> Verificación de checksum para Cask postman
==> Instalando Cask postman
==> Moviendo la aplicación 'Postman.app' a '/Applications/Postman.app'.
(brew) postman se instaló con éxito!

Verificación

1. Una vez que se complete la instalación, busque Postman en su carpeta de Aplicaciones.

2. Postman se abrirá y le permitirá registrarse o iniciar sesión. NO necesita iniciar sesión para utilizar Postman, simplemente puede hacer clic en el enlace "Llévame
directamente a la aplicación. Crearé una cuenta en otro momento". para evitar el inicio de sesión.
 3. Comprueba que puedes hacer llamadas a REST APIs con Postman con esta divertida API "Dad Joke". Ingrese https://icanhazdadjoke.com/ en la barra de
direcciones. Haga clic en la pestaña "Encabezados" y agregue una entrada para Aceptar con un valor de application/json . Luego haz clic en "Enviar" y disfruta de la

broma :-)

ngrok

Una herramienta como ngrok le ayuda a exponer un servidor local detrás de un NAT o firewall al resto de la red, incluido Internet.

Instalación

1. Abra una ventana de Terminal y utilice brew cask para instalar ngrok:

brew cask install ngrok

 # Salida de muestra
==> Satisfaciendo dependencisa
==> Descargando https://bin.equinox.io/c/4VmDzA7iaHb/ngrok-stable-darwin-amd64.zip
######################################################################### 100.0%
==> No hay suma de verificación definida para Cask ngrok, omitiendo la verificación
==> Instalación de Cask ngrok
==> Extracción de contenedor anidado ngrok
==> Vinculación del binario 'ngrok' a '/usr/local/bin/ngrok'.
(brew) ¡ngrok se instaló correctamente!

Verificación

1. Abra una ventana de Terminal y utilice el siguiente comando para inicializar un tunel ngrok.

ngrok http 5000

Debe ver la siguiente salida en su ventana de Terminal:

#Expected Output
ngrok by @inconshreveable
(Ctrl+C to quit)

Session Status online

Session Expires 7 hours, 59 minutes
Version 2.2.8
Region United States (us)
Web Interface http://127.0.0.1:4040
Forwarding http://f53d98ce.ngrok.io -> localhost:5000
Forwarding https://f53d98ce.ngrok.io -> localhost:5000
Connections ttl opn rt1 rt5 p50 p90
0 0 0.00 0.00 0.00 0.00

5. Presione Ctrl-C para salir de ngrok.

Google Chrome

Si ya tiene instalado Google Chrome, puede pasar a la sección Verificación para asegurarse de que puede acceder a las Herramientas para desarrolladores de Chrome. Esta
herramienta es útil para depurar páginas web y para ver el tráfico de red, incluidas las llamadas API enviadas a través de su navegador.

Instalación

1. Abra una ventana de terminal y utilice brew cask para instalar Google Chrome:

brew cask install google-chrome

==> Satisfaciendo dependencias

==> Descargando https://dl.google.com/chrome/mac/stable/GGRO/googlechrome.dmg
######################################################################## 100.0%
==> Verificación de checksum para Cask google-chrome
==> Instalando Cask google-chrome
==> Moviendo la aplicación 'Google Chrome.app' a '/Applications/Google Chrome.app'.
(brew) google-chrome se instaló con éxito!

Verificación

Asegúrese de que su instalación de Chrome pueda mostrarle las herramientas para desarrolladores. 1. Abra Google Chrome y haga clic en los "tres puntos" a la derecha de la
barra de direcciones para acceder al menú. En "Más herramientas", haga clic en el enlace "Herramientas para desarrolladores".
 2. A continuación se
abren las herramientas de desarrollo en la ventana.

OpenConnect

Si aún no cuenta con Cisco AnyConnect, puede instalar OpenConnect como cliente open-source de conexión a VPNs, para conectarse a los Sandbox de DevNet. Queremos
ofrecer una alternativa a Cisco AnyConnect para conexiones VPN, que son útiles para conectarse a DevNet Sandboxes.

Instalación
 1. Abra una terminal y utilice brew cask para instalar openconnect-gui.

brew cask install openconnect-gui

==> Satisfaciendo dependencias

==> Descargando https://github.com/openconnect/openconnect-gui/releases/download/v1.5.1/openconnect-gui-1.5.1-Darwin.dmg
######################################################################## 100.0%
==> Verificación de checksum para Cask openconnect-gui
==> Instalando Cask openconnect-gui
==> Moviendo la aplicación 'openconnect-gui.app' a '/Applications/openconnect-gui.app'.
(brew) openconnect-gui se instaló con éxito!

Verificación

1. Para verificar completamente la instalación de OpenConnect, necesitará un servidor VPN para conectarse. Si no tiene uno a la mano, vaya al Catálogo de Sandbox de
DevNet y reserve uno de nuestros posibles sandbox. Una vez que la reserva esté lista, se le proporcionarán las credenciales de VPN para conectarse.
2. Abra la GUI de OpenConnect y cree un "Nuevo perfil". Ingrese la dirección VPN como "Gateway" y "Save & Connect". Luego se le pedirá su nombre de usuario y

contraseña.
3. Ahora debe tener una conexión VPN activa a su sandbox y poder acceder a los recursos contenidos en su pod.

Paso 7: Motor de contenedores de aplicaciones

Docker es una herramienta de contenedorización estándar de la industria.

Docker

Los participantes de DevNet Express Cloud Collaboration for IT Pros pueden omitir la instalación de Docker

Instalación

1. Vaya a https://hub.docker.com/editions/community/docker-ce-desktop-mac
2. Cree un Docker ID para poder descargar Docker.
3. Haga login y click en Get Docker. Esta acción inicia la descarga de "Docker Community Edition para Mac".
4. Abra el archivo descargado, y luego arrastre la aplicación Docker a la carpeta de Aplicaciones para instalarlo.
5. Una vez que el archivo haya sido copiado, inicialice Docker desde la carpeta de Aplicaciones.

Verificación

1. Abra una ventana de Terminal.

2. Ingrese el siguiente comando para iniciar un contenedor de prueba basado con la imagen "busybox". Docker ejecutar busybox
3. El contenedor se iniciará y luego dejará de mostrar resultados. Verifique que funcionó con el siguiente comando.
docker ps -a

# Salida de muestra
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
d9a3285ba957 busybox "sh" 20 seconds ago Exited (0) 15 seconds ago quizzical_bartik