# Opción recomendada: gestor de paquetes de Windows.
winget install --exact --id Microsoft.AzureCLI

# Alternativa con MSI silencioso, útil en despliegues corporativos.
# Descarga el instalador oficial y ejecútalo con /quiet.

# Con Homebrew, el gestor de paquetes más habitual en macOS.
brew update && brew install azure-cli

# Script oficial de instalación: añade el repositorio de Microsoft e instala el paquete.
# Revisa siempre un script antes de ejecutarlo con privilegios (buena práctica general).
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

# Muestra la versión de la CLI, de sus extensiones y de Python.
az version

{
  "azure-cli": "2.64.0",
  "azure-cli-core": "2.64.0",
  "azure-cli-telemetry": "1.1.0",
  "extensions": {}
}

# Actualiza la CLI a la última versión estable (funciona en la mayoría de plataformas).
az upgrade

# Desactiva la pregunta de telemetría y confirmaciones interactivas en scripts.
az config set core.collect_telemetry=false

# Abre el navegador para autenticarte de forma interactiva.
# Tras iniciar sesión, la CLI guarda un token local y ya no lo pide en cada comando.
az login

# Sin navegador (servidores, SSH): muestra un código para introducir en microsoft.com/devicelogin.
az login --use-device-code

# Especificar el inquilino cuando tu identidad pertenece a varios directorios.
az login --tenant contoso-airlines.onmicrosoft.com

# Ver todas las suscripciones accesibles. IsDefault marca la activa.
az account list --output table

Name                              CloudName    SubscriptionId                        State    IsDefault
--------------------------------  -----------  ------------------------------------  -------  ---------
Contoso Airlines - Producción     AzureCloud   8f4c2b7a-1d3e-4a55-9c11-0a7b6e2d4f90  Enabled  True
Contoso Airlines - Desarrollo     AzureCloud   3b91e5d0-7c42-4f88-a2e6-5d9c1a8b3e77  Enabled  False

# Cambiar la suscripción activa (acepta nombre o identificador).
az account set --subscription "Contoso Airlines - Desarrollo"

# Confirmar dónde estás antes de tocar nada. Hazlo un hábito.
az account show --query "{Suscripcion:name, Id:id, Usuario:user.name}" --output table

az group delete --name rg-contoso-reservas-dev \
  --subscription "Contoso Airlines - Desarrollo" --yes

az <grupo> [<subgrupo>] <comando> [--parámetros]

az storage account create --name sttarjetascontosodev --resource-group rg-contoso-reservas-dev --location westeurope --sku Standard_LRS

# Ayuda de un grupo: muestra subgrupos y comandos disponibles.
az storage --help

# Ayuda de un comando concreto: lista TODOS sus parámetros, cuáles son obligatorios y ejemplos.
az storage account create --help

# Búsqueda inteligente por lenguaje natural, con ejemplos reales de uso.
az find "az storage account"
az find "crear una cuenta de almacenamiento"

# Autocompletado, descripciones de parámetros y ejemplos mientras escribes.
az interactive

# Devuelve solo la ubicación de un grupo de recursos, sin comillas (tsv), lista para una variable.
az group show --name rg-contoso-reservas-dev --query location --output tsv

# Nombres de todos los grupos de recursos. [] recorre la lista.
az group list --query "[].name" --output tsv

# Renombra los campos de salida. Las claves de la izquierda son etiquetas tuyas.
az group list \
  --query "[].{Nombre:name, Region:location, Estado:properties.provisioningState}" \
  --output table

Nombre                     Region      Estado
-------------------------  ----------  ---------
rg-contoso-reservas-dev    westeurope  Succeeded
rg-contoso-reservas-pro    westeurope  Succeeded

# Solo los grupos etiquetados como producción.
az group list \
  --query "[?tags.entorno=='produccion'].{Nombre:name, Propietario:tags.propietario}" \
  --output table

# Solo las cuentas de almacenamiento de West Europe.
az storage account list \
  --query "[?location=='westeurope'].{Cuenta:name, Grupo:resourceGroup, Sku:sku.name}" \
  --output table

# Recursos SIN la etiqueta obligatoria "propietario": el informe que pide Marta Ríos.
# == `null` compara con nulo; los acentos graves marcan un literal JSON.
az resource list \
  --query "[?tags.propietario == \`null\`].{Recurso:name, Tipo:type, Grupo:resourceGroup}" \
  --output table

# Contar cuántos recursos hay en total.
az resource list --query "length(@)" --output tsv

# Los recursos ordenados por nombre, mostrando solo tipo y grupo.
az resource list \
  --query "sort_by([].{Nombre:name, Tipo:type, Grupo:resourceGroup}, &Nombre)" \
  --output table

# Guardar un valor en una variable de shell. --output tsv evita las comillas del JSON.
CLAVE_REGION=$(az group show --name rg-contoso-reservas-dev --query location --output tsv)
echo "El grupo está en: $CLAVE_REGION"

# Instala el módulo Az para el usuario actual (no requiere permisos de administrador).
Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

# Inicia sesión (abre el navegador).
Connect-AzAccount

# Ver las suscripciones disponibles y seleccionar una.
Get-AzSubscription
Set-AzContext -Subscription "Contoso Airlines - Desarrollo"

# Crear el grupo de recursos de Contoso con sus etiquetas.
New-AzResourceGroup -Name "rg-contoso-reservas-dev" -Location "westeurope" -Tag @{
    entorno       = "desarrollo"
    proyecto      = "contoso-reservas"
    "centro-coste" = "CC-1042"
    propietario   = "[email protected]"
}

# Listar recursos y filtrar por etiqueta, aprovechando los objetos de PowerShell.
Get-AzResource -TagName "proyecto" -TagValue "contoso-reservas" |
    Select-Object Name, ResourceType, ResourceGroupName |
    Format-Table

#!/usr/bin/env bash
# =============================================================================
# desplegar-base-contoso.sh
# Crea la base de la plataforma de Contoso Airlines:
#   - Grupo de recursos con las etiquetas obligatorias
#   - Cuenta de almacenamiento para las tarjetas de embarque en PDF
#   - Contenedor privado "tarjetas-embarque"
#
# Es IDEMPOTENTE: ejecutarlo dos veces deja el mismo resultado que ejecutarlo una.
# Uso:   ./desplegar-base-contoso.sh [dev|pro]
# =============================================================================

# 'set -e' aborta el script ante el primer error, en lugar de seguir a ciegas.
# 'set -u' aborta si se usa una variable no definida (evita erratas peligrosas).
# 'set -o pipefail' propaga el error de cualquier comando dentro de una tubería.
set -euo pipefail

# ------------------------------------------------------------------
# 1. PARÁMETROS. Todo lo configurable, en un solo sitio y arriba.
# ------------------------------------------------------------------
ENTORNO="${1:-dev}"                       # Primer argumento; "dev" si no se indica
SUSCRIPCION="Contoso Airlines - Desarrollo"
REGION="westeurope"                       # Región principal decidida en la lección 01-02
PROYECTO="contoso-reservas"
CENTRO_COSTE="CC-1042"
PROPIETARIO="[email protected]"

# Nombres derivados, siguiendo la convención de nomenclatura de Contoso.
GRUPO="rg-${PROYECTO}-${ENTORNO}"          # p. ej. rg-contoso-reservas-dev
# Las cuentas de almacenamiento solo admiten minúsculas y números (3-24 caracteres)
# y su nombre es ÚNICO EN TODO AZURE: añadimos un sufijo aleatorio estable por si acaso.
SUFIJO="$(echo -n "${GRUPO}" | cksum | cut -c1-4)"
CUENTA_ALM="sttarjetascontoso${ENTORNO}${SUFIJO}"
CONTENEDOR="tarjetas-embarque"

# Traducción del entorno corto al valor de etiqueta que exige el esquema de Contoso.
if [ "${ENTORNO}" = "pro" ]; then
  ENTORNO_TAG="produccion"
else
  ENTORNO_TAG="desarrollo"
fi

echo "=== Despliegue de la base de Contoso Airlines (${ENTORNO_TAG}) ==="

# ------------------------------------------------------------------
# 2. CONTEXTO. Nunca confíes en la suscripción que estuviera activa.
# ------------------------------------------------------------------
az account set --subscription "${SUSCRIPCION}"
echo "Suscripción activa: $(az account show --query name --output tsv)"

# ------------------------------------------------------------------
# 3. PROVEEDORES. Necesarios en suscripciones nuevas; es inocuo repetirlo.
# ------------------------------------------------------------------
az provider register --namespace Microsoft.Storage --wait

# ------------------------------------------------------------------
# 4. GRUPO DE RECURSOS.
#    'az group create' ya es idempotente: si existe, actualiza sus etiquetas.
# ------------------------------------------------------------------
echo "--> Grupo de recursos: ${GRUPO}"
az group create \
  --name "${GRUPO}" \
  --location "${REGION}" \
  --tags entorno="${ENTORNO_TAG}" \
         proyecto="${PROYECTO}" \
         centro-coste="${CENTRO_COSTE}" \
         propietario="${PROPIETARIO}" \
  --output none

# ------------------------------------------------------------------
# 5. CUENTA DE ALMACENAMIENTO.
#    Comprobamos primero si existe, para que el script sea idempotente
#    y para no fallar si el nombre global ya está ocupado por otra persona.
# ------------------------------------------------------------------
echo "--> Cuenta de almacenamiento: ${CUENTA_ALM}"
if az storage account show --name "${CUENTA_ALM}" --resource-group "${GRUPO}" --output none 2>/dev/null; then
  echo "    Ya existe: no se vuelve a crear."
else
  # --sku Standard_LRS  : la opción más económica (redundancia local). Módulo 2.
  # --kind StorageV2    : tipo de cuenta actual, admite blobs, colas, tablas y archivos.
  # --min-tls-version   : fuerza TLS 1.2 como mínimo.
  # --allow-blob-public-access false : NADIE puede leer los PDF de forma anónima.
  # --https-only true   : rechaza el tráfico sin cifrar.
  az storage account create \
    --name "${CUENTA_ALM}" \
    --resource-group "${GRUPO}" \
    --location "${REGION}" \
    --sku Standard_LRS \
    --kind StorageV2 \
    --min-tls-version TLS1_2 \
    --https-only true \
    --allow-blob-public-access false \
    --tags entorno="${ENTORNO_TAG}" \
           proyecto="${PROYECTO}" \
           centro-coste="${CENTRO_COSTE}" \
           propietario="${PROPIETARIO}" \
    --output none
  echo "    Creada."
fi

# ------------------------------------------------------------------
# 6. CONTENEDOR DE BLOBS.
#    --auth-mode login usa TU identidad de Entra ID en lugar de la clave de la
#    cuenta: es la forma recomendada y no expone secretos en el script.
#    (Requiere tener un rol de datos, p. ej. "Colaborador de datos de Blob".)
# ------------------------------------------------------------------
echo "--> Contenedor: ${CONTENEDOR}"
az storage container create \
  --name "${CONTENEDOR}" \
  --account-name "${CUENTA_ALM}" \
  --auth-mode login \
  --public-access off \
  --output none

# ------------------------------------------------------------------
# 7. RESUMEN. Comprobación final legible de lo desplegado.
# ------------------------------------------------------------------
echo ""
echo "=== Despliegue completado ==="
az resource list \
  --resource-group "${GRUPO}" \
  --query "[].{Recurso:name, Tipo:type, Region:location}" \
  --output table

echo ""
echo "Para eliminar TODO lo creado y dejar de pagar, ejecuta:"
echo "  az group delete --name ${GRUPO} --yes --no-wait"

# Dar permisos de ejecución (solo la primera vez).
chmod +x desplegar-base-contoso.sh

# Desplegar el entorno de desarrollo.
./desplegar-base-contoso.sh dev

# Borra el grupo y ABSOLUTAMENTE TODO lo que contiene. Es irreversible.
# --yes     : no pide confirmación (úsalo solo cuando estés seguro).
# --no-wait : devuelve el control inmediatamente; el borrado sigue en segundo plano.
az group delete --name rg-contoso-reservas-dev --yes --no-wait

# Antes: ver exactamente qué se va a destruir.
az resource list --resource-group rg-contoso-reservas-dev --output table

# Después: confirmar que el grupo ya no existe (devuelve "false").
az group exists --name rg-contoso-reservas-dev

# Lista TODOS los grupos de recursos con sus etiquetas: buscando huérfanos y olvidos.
az group list --query "[].{Grupo:name, Region:location, Entorno:tags.entorno, Propietario:tags.propietario}" --output table

# Busca discos que ya no están conectados a ninguna máquina virtual: gasto puro.
az disk list --query "[?diskState=='Unattached'].{Disco:name, Grupo:resourceGroup, GB:diskSizeGb}" --output table

# Busca direcciones IP públicas sin asociar: también se facturan.
az network public-ip list --query "[?ipConfiguration==null].{IP:name, Grupo:resourceGroup}" --output table

az group create --name rg-contoso-millas-dev --location westeurope --tags entorno=desarrollo proyecto=contoso-millas
az group delete --name rg-contoso-millas-dev --yes

# 1. Grupos de recursos con nombre y región.
az group list --query "[].{Grupo:name, Region:location}" --output table

# 2. Recursos del proyecto.
az resource list --tag proyecto=contoso-reservas \
  --query "[].{Recurso:name, Tipo:type, Grupo:resourceGroup}" --output table

# 3. Recursos SIN la etiqueta centro-coste.
az resource list \
  --query "[?tags.\"centro-coste\" == \`null\`].{Recurso:name, Tipo:type, Grupo:resourceGroup}" \
  --output table

# 4. Región del grupo de producción en una variable.
REGION_PRO=$(az group show --name rg-contoso-reservas-pro --query location --output tsv)
echo "$REGION_PRO"

# Junto al resto de parámetros:
if [ "${ENTORNO}" = "pro" ]; then
  CRITICIDAD="alta"
else
  CRITICIDAD="baja"
fi

# Y se añade al bloque de --tags de az group create y de az storage account create:
#   criticidad="${CRITICIDAD}"

if [ "${ENTORNO}" = "pro" ]; then
  echo "--> Aplicando bloqueo CanNotDelete al grupo de producción"
  # 'az lock create' falla si ya existe un bloqueo con ese nombre;
  # comprobamos primero para mantener la idempotencia del script.
  if ! az lock show --name "no-borrar-produccion" --resource-group "${GRUPO}" --output none 2>/dev/null; then
    az lock create \
      --name "no-borrar-produccion" \
      --lock-type CanNotDelete \
      --resource-group "${GRUPO}" \
      --notes "Plataforma de venta en produccion. Retirar solo con autorizacion." \
      --output none
  fi
fi

New-AzResourceGroup -Name "rg-contoso-millas-dev" -Location "westeurope" -Tag @{
    entorno  = "desarrollo"
    proyecto = "contoso-millas"
}

Remove-AzResourceGroup -Name "rg-contoso-millas-dev" -Force

az disk list --query "[?diskState=='Unattached'].{Disco:name, Grupo:resourceGroup, GB:diskSizeGb}" --output table
az network public-ip list --query "[?ipConfiguration==null].{IP:name, Grupo:resourceGroup}" --output table