Saltar al contenido principal

First steps

Esta guía te ayudará a configurar tu entorno de desarrollo con todas las herramientas y servicios necesarios para trabajar.

Configuración de Servicios y Cuentas​

📧 Correo Institucional (Outlook)​

  1. Configuración de cuenta:

    • Recibirás un correo de invitación en tu correo personal
    • Sigue las instrucciones para activar tu cuenta
    • Configura tu contraseña siguiendo las medidas de seguridad pertinentes

  2. Configuración en dispositivos:

    • Web: Accede a outlook.office.com
    • macOS Mail: Configura como cuenta Exchange
    • Mobile: Descarga la app Microsoft Outlook

💬 Slack​

  1. Aceptar invitación:

    • Busca el correo de invitación en tu bandeja de entrada
    • Haz clic en "Join Team" o "Unirse al equipo"
    • Crea tu perfil y configura tu foto

  2. Configuración recomendada:

    • Descarga la aplicación de escritorio
    • Configura notificaciones según tus preferencias
    • Únete a los canales relevantes para tu equipo

🎮 Gather​

  1. Acceso:
    • Recibirás una invitación por correo electrónico
    • Acepta la invitación y crea tu avatar
    • Configura tu micrófono y cámara

🪣 Github​

  1. Acceso:
  • Crea tu cuenta o asocia el correo intitucional a tu cuenta de Github
  • Busca en tu correo la invitación a la organización de Copan IT
  • Clona los repos necesarios para trabajar

Instalación de Herramientas de Desarrollo​

🍺 Homebrew (Gestor de Paquetes)​

Primero instala Homebrew o tu manejador de paquetes favorito que usaremos para instalar las demás herramientas:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Después de la instalación, agrega Homebrew a tu PATH:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

📦 Node.js​

Instala Node.js usando Homebrew:

# Instalar Node.js LTS
brew install node

Verifica la instalación:

node --version
npm --version

Alternativa: Usar nvm para manejar múltiples versiones

# Instalar nvm
brew install nvm

# Configurar nvm en tu shell
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"' >> ~/.zshrc
source ~/.zshrc

# Instalar la última versión LTS de Node.js
nvm install --lts
nvm use --lts

🐍 Python con pyenv​

Instala pyenv para manejar múltiples versiones de Python:

# Instalar pyenv
brew update
brew install pyenv

Configura pyenv en tu shell:

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
source ~/.zshrc

Instala Python:

# Ver versiones disponibles
pyenv install --list

# Instalar Python 3.11 (recomendado)
pyenv install 3.11.7

# Establecer como versión global
pyenv global 3.11.7

# Verificar instalación
python --version
pip --version

🐳 Docker​

Instala Docker Desktop usando Homebrew:

# Instalar Docker Desktop
brew install --cask docker
docker --version
docker-compose --version

Nota: Docker Desktop incluye Docker Engine, Docker CLI, y Docker Compose.

Configuración de AWS CLI v2​

Instalación​

# Instalar AWS CLI v2
brew install awscli

Verifica la instalación:

aws --version

Configuración con AWS SSO​

  1. Configurar perfil SSO:
aws configure sso

Te pedirá la siguiente información:

  • SSO Session name: company-sso (o el nombre que prefieras)
  • SSO Start URL: https://your-sso-portal.awsapps.com/start (proporcionado por tu administrador)
  • SSO Region: us-east-1 (o la región configurada)
  • SSO registration scopes: sso:account:access

  1. Proceso de autenticación:

    • Se abrirá tu navegador automáticamente
    • Inicia sesión con tus credenciales corporativas
    • Selecciona la cuenta AWS apropiada
    • Selecciona el rol que te corresponde

  2. Completar configuración:

    • Default client region: us-east-1 (o tu región preferida)
    • Default output format: json
    • Profile name: company-dev (o el nombre que prefieras)

Uso diario de AWS SSO​

Para iniciar sesión en AWS SSO:

aws sso login --profile company-dev

Para usar un comando con tu perfil:

aws sts get-caller-identity --profile company-dev

Para cerrar sesión:

aws sso logout

Consejo: Establece tu perfil como predeterminado:

export AWS_PROFILE=company-dev
echo 'export AWS_PROFILE=company-dev' >> ~/.zshrc

Repositorios​

Clonar Repositorio "Arquitectura"​

# Navegar a tu directorio de proyectos
cd ~/Projects  # o el directorio que prefieras

# Clonar el repositorio
git clone [URL_DEL_REPOSITORIO_ARQUITECTURA]

# Navegar al repositorio
cd arquitectura

# Instalar dependencias (si aplica)
npm install  # para proyectos Node.js
pip install -r requirements.txt  # para proyectos Python

Verificación de Instalación​

Ejecuta estos comandos para verificar que todo esté instalado correctamente:

# Verificar Homebrew
brew --version

# Verificar Node.js y npm
node --version && npm --version

# Verificar Python y pip
python --version && pip --version

# Verificar pyenv
pyenv --version

# Verificar Docker
docker --version

# Verificar AWS CLI
aws --version

# Verificar Git
git --version

Problemas con Python y pyenv​

Si pyenv no encuentra las versiones de Python, instala las dependencias necesarias:

brew install openssl readline sqlite3 xz zlib tcl-tk

Problemas con Docker​

Si Docker no inicia correctamente:

  1. Abre Docker Desktop manualmente
  2. Ve a Preferences > Resources y ajusta la memoria asignada
  3. Reinicia Docker Desktop

Recursos Adicionales​