gitlab-skill 1.0.0

package/PRACTICAL_SCRIPTS.md

@@ -0,0 +1,1351 @@
+# GitLab API - Scripts Prácticos
+
+> Colección de scripts completos y listos para usar
+
+---
+
+## Tabla de Contenidos
+
+1. [Configuración Inicial](#configuración-inicial)
+2. [Scripts de Proyectos](#scripts-de-proyectos)
+3. [Scripts de Issues](#scripts-de-issues)
+4. [Scripts de Merge Requests](#scripts-de-merge-requests)
+5. [Scripts de Pipelines](#scripts-de-pipelines)
+6. [Scripts de Repository](#scripts-de-repository)
+7. [Scripts de Monitoreo](#scripts-de-monitoreo)
+8. [Scripts de Automatización](#scripts-de-automatización)
+
+---
+
+## Configuración Inicial
+
+### Script: setup-gitlab-env.sh
+
+```bash
+#!/bin/bash
+
+# setup-gitlab-env.sh
+# Configura variables de entorno para GitLab API
+
+set -e
+
+echo "=== GitLab API Setup ==="
+echo ""
+
+# Solicitar información
+read -p "GitLab Host (default: https://gitlab.com): " GITLAB_HOST
+GITLAB_HOST=${GITLAB_HOST:-https://gitlab.com}
+
+read -sp "GitLab Token: " GITLAB_TOKEN
+echo ""
+
+# Validar token
+echo "Validating token..."
+RESPONSE=$(curl --silent --write-out "HTTPSTATUS:%{http_code}" \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --url "$GITLAB_HOST/api/v4/user")
+
+HTTP_STATUS=$(echo "$RESPONSE" | tr -d '\n' | sed -e 's/.*HTTPSTATUS://')
+BODY=$(echo "$RESPONSE" | sed -e 's/HTTPSTATUS\:.*//g')
+
+if [ "$HTTP_STATUS" -eq 200 ]; then
+  USERNAME=$(echo "$BODY" | jq -r '.username')
+  echo "✅ Token válido. Usuario: $USERNAME"
+  
+  # Guardar en archivo .env
+  cat > .gitlab-env << EOF
+export GITLAB_HOST="$GITLAB_HOST"
+export GITLAB_TOKEN="$GITLAB_TOKEN"
+export GITLAB_API_URL="$GITLAB_HOST/api/v4"
+EOF
+  
+  echo ""
+  echo "✅ Configuración guardada en .gitlab-env"
+  echo "Para usar: source .gitlab-env"
+else
+  echo "❌ Token inválido o error de conexión"
+  exit 1
+fi
+```
+
+---
+
+## Scripts de Proyectos
+
+### Script: list-all-projects.sh
+
+```bash
+#!/bin/bash
+
+# list-all-projects.sh
+# Lista todos los proyectos con paginación automática
+
+source .gitlab-env
+
+OUTPUT_FILE="projects.json"
+page=1
+all_projects="[]"
+
+echo "Obteniendo proyectos..."
+
+while true; do
+  echo "Página $page..."
+  
+  response=$(curl --silent \
+    --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+    --url "$GITLAB_API_URL/projects?page=$page&per_page=100&simple=true")
+  
+  # Verificar si hay proyectos
+  count=$(echo "$response" | jq '. | length')
+  
+  if [ "$count" -eq 0 ]; then
+    break
+  fi
+  
+  # Agregar a la lista
+  all_projects=$(echo "$all_projects" | jq ". + $response")
+  
+  page=$((page + 1))
+done
+
+# Guardar resultados
+echo "$all_projects" > "$OUTPUT_FILE"
+
+total=$(echo "$all_projects" | jq '. | length')
+echo ""
+echo "✅ Total de proyectos: $total"
+echo "📄 Guardado en: $OUTPUT_FILE"
+
+# Mostrar resumen
+echo ""
+echo "Top 10 proyectos:"
+echo "$all_projects" | jq -r '.[:10] | .[] | "\(.id) - \(.name_with_namespace)"'
+```
+
+### Script: create-project.sh
+
+```bash
+#!/bin/bash
+
+# create-project.sh
+# Crea un nuevo proyecto con configuración completa
+
+source .gitlab-env
+
+# Parámetros
+PROJECT_NAME="${1:-}"
+PROJECT_PATH="${2:-}"
+DESCRIPTION="${3:-}"
+VISIBILITY="${4:-private}"
+
+if [ -z "$PROJECT_NAME" ]; then
+  read -p "Nombre del proyecto: " PROJECT_NAME
+fi
+
+if [ -z "$PROJECT_PATH" ]; then
+  PROJECT_PATH=$(echo "$PROJECT_NAME" | tr '[:upper:]' '[:lower:]' | tr ' ' '-')
+fi
+
+if [ -z "$DESCRIPTION" ]; then
+  read -p "Descripción: " DESCRIPTION
+fi
+
+echo "Creando proyecto..."
+echo "  Nombre: $PROJECT_NAME"
+echo "  Path: $PROJECT_PATH"
+echo "  Visibilidad: $VISIBILITY"
+
+response=$(curl --silent --write-out "HTTPSTATUS:%{http_code}" \
+  --request POST \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --header "Content-Type: application/json" \
+  --data "{
+    \"name\": \"$PROJECT_NAME\",
+    \"path\": \"$PROJECT_PATH\",
+    \"description\": \"$DESCRIPTION\",
+    \"visibility\": \"$VISIBILITY\",
+    \"initialize_with_readme\": true,
+    \"issues_enabled\": true,
+    \"merge_requests_enabled\": true,
+    \"wiki_enabled\": true,
+    \"snippets_enabled\": true,
+    \"builds_enabled\": true
+  }" \
+  --url "$GITLAB_API_URL/projects")
+
+HTTP_STATUS=$(echo "$response" | tr -d '\n' | sed -e 's/.*HTTPSTATUS://')
+BODY=$(echo "$response" | sed -e 's/HTTPSTATUS\:.*//g')
+
+if [ "$HTTP_STATUS" -eq 201 ]; then
+  PROJECT_ID=$(echo "$BODY" | jq -r '.id')
+  WEB_URL=$(echo "$BODY" | jq -r '.web_url')
+  
+  echo ""
+  echo "✅ Proyecto creado exitosamente"
+  echo "   ID: $PROJECT_ID"
+  echo "   URL: $WEB_URL"
+else
+  echo ""
+  echo "❌ Error al crear proyecto"
+  echo "$BODY" | jq '.'
+  exit 1
+fi
+```
+
+### Script: clone-project-settings.sh
+
+```bash
+#!/bin/bash
+
+# clone-project-settings.sh
+# Clona configuración de un proyecto a otro
+
+source .gitlab-env
+
+SOURCE_PROJECT_ID="$1"
+TARGET_PROJECT_ID="$2"
+
+if [ -z "$SOURCE_PROJECT_ID" ] || [ -z "$TARGET_PROJECT_ID" ]; then
+  echo "Uso: $0 <source_project_id> <target_project_id>"
+  exit 1
+fi
+
+echo "Clonando configuración..."
+echo "  Origen: $SOURCE_PROJECT_ID"
+echo "  Destino: $TARGET_PROJECT_ID"
+
+# Obtener configuración del proyecto origen
+source_config=$(curl --silent \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --url "$GITLAB_API_URL/projects/$SOURCE_PROJECT_ID")
+
+# Extraer configuración relevante
+visibility=$(echo "$source_config" | jq -r '.visibility')
+issues_enabled=$(echo "$source_config" | jq -r '.issues_enabled')
+merge_requests_enabled=$(echo "$source_config" | jq -r '.merge_requests_enabled')
+wiki_enabled=$(echo "$source_config" | jq -r '.wiki_enabled')
+builds_enabled=$(echo "$source_config" | jq -r '.builds_enabled')
+auto_devops_enabled=$(echo "$source_config" | jq -r '.auto_devops_enabled')
+
+# Aplicar configuración al proyecto destino
+curl --request PUT \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --header "Content-Type: application/json" \
+  --data "{
+    \"visibility\": \"$visibility\",
+    \"issues_enabled\": $issues_enabled,
+    \"merge_requests_enabled\": $merge_requests_enabled,
+    \"wiki_enabled\": $wiki_enabled,
+    \"builds_enabled\": $builds_enabled,
+    \"auto_devops_enabled\": $auto_devops_enabled
+  }" \
+  --url "$GITLAB_API_URL/projects/$TARGET_PROJECT_ID"
+
+echo ""
+echo "✅ Configuración clonada exitosamente"
+```
+
+---
+
+## Scripts de Issues
+
+### Script: create-issue-from-template.sh
+
+```bash
+#!/bin/bash
+
+# create-issue-from-template.sh
+# Crea issues desde un template CSV
+
+source .gitlab-env
+
+PROJECT_ID="$1"
+CSV_FILE="$2"
+
+if [ -z "$PROJECT_ID" ] || [ -z "$CSV_FILE" ]; then
+  echo "Uso: $0 <project_id> <csv_file>"
+  echo ""
+  echo "Formato CSV: title,description,labels,assignee_username"
+  exit 1
+fi
+
+if [ ! -f "$CSV_FILE" ]; then
+  echo "❌ Archivo no encontrado: $CSV_FILE"
+  exit 1
+fi
+
+echo "Creando issues desde $CSV_FILE..."
+echo ""
+
+created=0
+failed=0
+
+# Leer CSV (skip header)
+tail -n +2 "$CSV_FILE" | while IFS=',' read -r title description labels assignee_username; do
+  echo "Creando: $title"
+  
+  # Obtener assignee ID si se especificó
+  assignee_id=""
+  if [ -n "$assignee_username" ]; then
+    assignee_id=$(curl --silent \
+      --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+      --url "$GITLAB_API_URL/users?username=$assignee_username" \
+      | jq -r '.[0].id')
+  fi
+  
+  # Crear issue
+  response=$(curl --silent --write-out "HTTPSTATUS:%{http_code}" \
+    --request POST \
+    --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+    --header "Content-Type: application/json" \
+    --data "{
+      \"title\": \"$title\",
+      \"description\": \"$description\",
+      \"labels\": \"$labels\"
+      $([ -n "$assignee_id" ] && echo ", \"assignee_ids\": [$assignee_id]")
+    }" \
+    --url "$GITLAB_API_URL/projects/$PROJECT_ID/issues")
+  
+  HTTP_STATUS=$(echo "$response" | tr -d '\n' | sed -e 's/.*HTTPSTATUS://')
+  
+  if [ "$HTTP_STATUS" -eq 201 ]; then
+    created=$((created + 1))
+    echo "  ✅ Creado"
+  else
+    failed=$((failed + 1))
+    echo "  ❌ Error"
+  fi
+  
+  # Rate limiting
+  sleep 0.5
+done
+
+echo ""
+echo "Resumen:"
+echo "  ✅ Creados: $created"
+echo "  ❌ Fallidos: $failed"
+```
+
+### Script: export-issues.sh
+
+```bash
+#!/bin/bash
+
+# export-issues.sh
+# Exporta todas las issues de un proyecto a JSON/CSV
+
+source .gitlab-env
+
+PROJECT_ID="$1"
+FORMAT="${2:-json}"  # json o csv
+
+if [ -z "$PROJECT_ID" ]; then
+  echo "Uso: $0 <project_id> [format]"
+  echo "  format: json (default) o csv"
+  exit 1
+fi
+
+OUTPUT_FILE="issues-$PROJECT_ID.$FORMAT"
+page=1
+all_issues="[]"
+
+echo "Exportando issues del proyecto $PROJECT_ID..."
+
+while true; do
+  echo "Página $page..."
+  
+  response=$(curl --silent \
+    --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+    --url "$GITLAB_API_URL/projects/$PROJECT_ID/issues?page=$page&per_page=100")
+  
+  count=$(echo "$response" | jq '. | length')
+  
+  if [ "$count" -eq 0 ]; then
+    break
+  fi
+  
+  all_issues=$(echo "$all_issues" | jq ". + $response")
+  page=$((page + 1))
+done
+
+total=$(echo "$all_issues" | jq '. | length')
+
+if [ "$FORMAT" = "json" ]; then
+  echo "$all_issues" > "$OUTPUT_FILE"
+elif [ "$FORMAT" = "csv" ]; then
+  echo "iid,title,state,labels,assignee,created_at,updated_at,web_url" > "$OUTPUT_FILE"
+  echo "$all_issues" | jq -r '.[] | [
+    .iid,
+    .title,
+    .state,
+    (.labels | join(";")),
+    (.assignees[0].username // ""),
+    .created_at,
+    .updated_at,
+    .web_url
+  ] | @csv' >> "$OUTPUT_FILE"
+fi
+
+echo ""
+echo "✅ Exportadas $total issues"
+echo "📄 Guardado en: $OUTPUT_FILE"
+```
+
+### Script: bulk-close-issues.sh
+
+```bash
+#!/bin/bash
+
+# bulk-close-issues.sh
+# Cierra issues en bulk por label o milestone
+
+source .gitlab-env
+
+PROJECT_ID="$1"
+FILTER_TYPE="$2"  # label o milestone
+FILTER_VALUE="$3"
+
+if [ -z "$PROJECT_ID" ] || [ -z "$FILTER_TYPE" ] || [ -z "$FILTER_VALUE" ]; then
+  echo "Uso: $0 <project_id> <filter_type> <filter_value>"
+  echo "  filter_type: label o milestone"
+  echo ""
+  echo "Ejemplos:"
+  echo "  $0 123 label bug"
+  echo "  $0 123 milestone v1.0"
+  exit 1
+fi
+
+# Construir URL según filtro
+if [ "$FILTER_TYPE" = "label" ]; then
+  FILTER_PARAM="labels=$FILTER_VALUE"
+elif [ "$FILTER_TYPE" = "milestone" ]; then
+  FILTER_PARAM="milestone=$FILTER_VALUE"
+else
+  echo "❌ Tipo de filtro inválido: $FILTER_TYPE"
+  exit 1
+fi
+
+echo "Obteniendo issues con $FILTER_TYPE=$FILTER_VALUE..."
+
+issues=$(curl --silent \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --url "$GITLAB_API_URL/projects/$PROJECT_ID/issues?state=opened&$FILTER_PARAM&per_page=100")
+
+count=$(echo "$issues" | jq '. | length')
+
+if [ "$count" -eq 0 ]; then
+  echo "No se encontraron issues abiertas"
+  exit 0
+fi
+
+echo "Encontradas $count issues abiertas"
+echo ""
+read -p "¿Cerrar todas? (y/n): " confirm
+
+if [ "$confirm" != "y" ]; then
+  echo "Cancelado"
+  exit 0
+fi
+
+closed=0
+failed=0
+
+echo "$issues" | jq -r '.[].iid' | while read -r iid; do
+  echo "Cerrando issue #$iid..."
+  
+  response=$(curl --silent --write-out "HTTPSTATUS:%{http_code}" \
+    --request PUT \
+    --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+    --header "Content-Type: application/json" \
+    --data '{"state_event": "close"}' \
+    --url "$GITLAB_API_URL/projects/$PROJECT_ID/issues/$iid")
+  
+  HTTP_STATUS=$(echo "$response" | tr -d '\n' | sed -e 's/.*HTTPSTATUS://')
+  
+  if [ "$HTTP_STATUS" -eq 200 ]; then
+    closed=$((closed + 1))
+  else
+    failed=$((failed + 1))
+  fi
+  
+  sleep 0.3
+done
+
+echo ""
+echo "Resumen:"
+echo "  ✅ Cerradas: $closed"
+echo "  ❌ Fallidas: $failed"
+```
+
+---
+
+## Scripts de Merge Requests
+
+### Script: create-mr-from-branch.sh
+
+```bash
+#!/bin/bash
+
+# create-mr-from-branch.sh
+# Crea MR automáticamente desde branch actual
+
+source .gitlab-env
+
+# Detectar branch actual
+CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+if [ "$CURRENT_BRANCH" = "main" ] || [ "$CURRENT_BRANCH" = "master" ]; then
+  echo "❌ No puedes crear MR desde la rama principal"
+  exit 1
+fi
+
+# Detectar proyecto desde remote
+REMOTE_URL=$(git config --get remote.origin.url)
+PROJECT_PATH=$(echo "$REMOTE_URL" | sed -E 's|.*[:/]([^/]+/[^/]+)\.git|\1|')
+
+echo "Creando MR..."
+echo "  Branch: $CURRENT_BRANCH"
+echo "  Proyecto: $PROJECT_PATH"
+
+# Obtener project ID
+PROJECT_ID=$(curl --silent \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --url "$GITLAB_API_URL/projects/$(echo "$PROJECT_PATH" | sed 's|/|%2F|g')" \
+  | jq -r '.id')
+
+if [ "$PROJECT_ID" = "null" ]; then
+  echo "❌ No se pudo obtener ID del proyecto"
+  exit 1
+fi
+
+# Generar título desde nombre de branch
+TITLE=$(echo "$CURRENT_BRANCH" | sed 's|-| |g' | sed 's|_| |g')
+TITLE=$(echo "$TITLE" | awk '{for(i=1;i<=NF;i++)sub(/./,toupper(substr($i,1,1)),$i)}1')
+
+read -p "Título del MR [$TITLE]: " INPUT_TITLE
+TITLE=${INPUT_TITLE:-$TITLE}
+
+read -p "Target branch [main]: " TARGET_BRANCH
+TARGET_BRANCH=${TARGET_BRANCH:-main}
+
+# Crear MR
+response=$(curl --silent --write-out "HTTPSTATUS:%{http_code}" \
+  --request POST \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --header "Content-Type: application/json" \
+  --data "{
+    \"source_branch\": \"$CURRENT_BRANCH\",
+    \"target_branch\": \"$TARGET_BRANCH\",
+    \"title\": \"$TITLE\",
+    \"remove_source_branch\": true
+  }" \
+  --url "$GITLAB_API_URL/projects/$PROJECT_ID/merge_requests")
+
+HTTP_STATUS=$(echo "$response" | tr -d '\n' | sed -e 's/.*HTTPSTATUS://')
+BODY=$(echo "$response" | sed -e 's/HTTPSTATUS\:.*//g')
+
+if [ "$HTTP_STATUS" -eq 201 ]; then
+  MR_IID=$(echo "$BODY" | jq -r '.iid')
+  WEB_URL=$(echo "$BODY" | jq -r '.web_url')
+  
+  echo ""
+  echo "✅ MR creado exitosamente"
+  echo "   IID: !$MR_IID"
+  echo "   URL: $WEB_URL"
+else
+  echo ""
+  echo "❌ Error al crear MR"
+  echo "$BODY" | jq '.'
+  exit 1
+fi
+```
+
+### Script: auto-approve-mrs.sh
+
+```bash
+#!/bin/bash
+
+# auto-approve-mrs.sh
+# Aprueba automáticamente MRs que cumplen criterios
+
+source .gitlab-env
+
+PROJECT_ID="$1"
+
+if [ -z "$PROJECT_ID" ]; then
+  echo "Uso: $0 <project_id>"
+  exit 1
+fi
+
+echo "Buscando MRs para aprobar en proyecto $PROJECT_ID..."
+
+# Obtener MRs abiertos
+mrs=$(curl --silent \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --url "$GITLAB_API_URL/projects/$PROJECT_ID/merge_requests?state=opened")
+
+approved=0
+skipped=0
+
+echo "$mrs" | jq -c '.[]' | while read -r mr; do
+  iid=$(echo "$mr" | jq -r '.iid')
+  title=$(echo "$mr" | jq -r '.title')
+  pipeline_status=$(echo "$mr" | jq -r '.pipeline.status // "none"')
+  has_conflicts=$(echo "$mr" | jq -r '.has_conflicts')
+  
+  echo ""
+  echo "MR !$iid: $title"
+  echo "  Pipeline: $pipeline_status"
+  echo "  Conflicts: $has_conflicts"
+  
+  # Criterios de auto-aprobación
+  if [ "$pipeline_status" = "success" ] && [ "$has_conflicts" = "false" ]; then
+    echo "  ✅ Aprobando..."
+    
+    curl --silent \
+      --request POST \
+      --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+      --url "$GITLAB_API_URL/projects/$PROJECT_ID/merge_requests/$iid/approve" \
+      > /dev/null
+    
+    approved=$((approved + 1))
+  else
+    echo "  ⏭️  Omitiendo (no cumple criterios)"
+    skipped=$((skipped + 1))
+  fi
+done
+
+echo ""
+echo "Resumen:"
+echo "  ✅ Aprobados: $approved"
+echo "  ⏭️  Omitidos: $skipped"
+```
+
+---
+
+## Scripts de Pipelines
+
+### Script: monitor-pipeline.sh
+
+```bash
+#!/bin/bash
+
+# monitor-pipeline.sh
+# Monitorea pipeline en tiempo real
+
+source .gitlab-env
+
+PROJECT_ID="$1"
+PIPELINE_ID="$2"
+
+if [ -z "$PROJECT_ID" ] || [ -z "$PIPELINE_ID" ]; then
+  echo "Uso: $0 <project_id> <pipeline_id>"
+  exit 1
+fi
+
+echo "Monitoreando pipeline $PIPELINE_ID..."
+echo ""
+
+previous_status=""
+
+while true; do
+  response=$(curl --silent \
+    --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+    --url "$GITLAB_API_URL/projects/$PROJECT_ID/pipelines/$PIPELINE_ID")
+  
+  status=$(echo "$response" | jq -r '.status')
+  duration=$(echo "$response" | jq -r '.duration // 0')
+  
+  # Solo mostrar si cambió el estado
+  if [ "$status" != "$previous_status" ]; then
+    timestamp=$(date '+%Y-%m-%d %H:%M:%S')
+    echo "[$timestamp] Status: $status (Duration: ${duration}s)"
+    
+    # Mostrar jobs
+    jobs=$(curl --silent \
+      --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+      --url "$GITLAB_API_URL/projects/$PROJECT_ID/pipelines/$PIPELINE_ID/jobs")
+    
+    echo "$jobs" | jq -r '.[] | "  - \(.name): \(.status)"'
+    echo ""
+    
+    previous_status="$status"
+  fi
+  
+  # Verificar si terminó
+  if [[ "$status" == "success" || "$status" == "failed" || "$status" == "canceled" ]]; then
+    echo "Pipeline finalizado con estado: $status"
+    
+    if [ "$status" = "success" ]; then
+      exit 0
+    else
+      exit 1
+    fi
+  fi
+  
+  sleep 10
+done
+```
+
+### Script: trigger-pipeline-with-vars.sh
+
+```bash
+#!/bin/bash
+
+# trigger-pipeline-with-vars.sh
+# Ejecuta pipeline con variables personalizadas
+
+source .gitlab-env
+
+PROJECT_ID="$1"
+REF="${2:-main}"
+
+if [ -z "$PROJECT_ID" ]; then
+  echo "Uso: $0 <project_id> [ref]"
+  exit 1
+fi
+
+echo "Configurar variables para pipeline..."
+echo ""
+
+variables="[]"
+
+while true; do
+  read -p "Variable key (Enter para terminar): " key
+  
+  if [ -z "$key" ]; then
+    break
+  fi
+  
+  read -p "Variable value: " value
+  
+  variables=$(echo "$variables" | jq ". + [{\"key\": \"$key\", \"value\": \"$value\"}]")
+  echo "  ✅ Agregada: $key"
+done
+
+if [ "$(echo "$variables" | jq '. | length')" -eq 0 ]; then
+  echo "No se agregaron variables"
+  variables_json=""
+else
+  variables_json=", \"variables\": $variables"
+fi
+
+echo ""
+echo "Ejecutando pipeline en $REF..."
+
+response=$(curl --silent --write-out "HTTPSTATUS:%{http_code}" \
+  --request POST \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --header "Content-Type: application/json" \
+  --data "{\"ref\": \"$REF\"$variables_json}" \
+  --url "$GITLAB_API_URL/projects/$PROJECT_ID/pipeline")
+
+HTTP_STATUS=$(echo "$response" | tr -d '\n' | sed -e 's/.*HTTPSTATUS://')
+BODY=$(echo "$response" | sed -e 's/HTTPSTATUS\:.*//g')
+
+if [ "$HTTP_STATUS" -eq 201 ]; then
+  PIPELINE_ID=$(echo "$BODY" | jq -r '.id')
+  WEB_URL=$(echo "$BODY" | jq -r '.web_url')
+  
+  echo ""
+  echo "✅ Pipeline creado"
+  echo "   ID: $PIPELINE_ID"
+  echo "   URL: $WEB_URL"
+  echo ""
+  
+  read -p "¿Monitorear pipeline? (y/n): " monitor
+  
+  if [ "$monitor" = "y" ]; then
+    exec "$0/../monitor-pipeline.sh" "$PROJECT_ID" "$PIPELINE_ID"
+  fi
+else
+  echo ""
+  echo "❌ Error al crear pipeline"
+  echo "$BODY" | jq '.'
+  exit 1
+fi
+```
+
+### Script: retry-failed-jobs.sh
+
+```bash
+#!/bin/bash
+
+# retry-failed-jobs.sh
+# Reintenta todos los jobs fallidos de un pipeline
+
+source .gitlab-env
+
+PROJECT_ID="$1"
+PIPELINE_ID="$2"
+
+if [ -z "$PROJECT_ID" ] || [ -z "$PIPELINE_ID" ]; then
+  echo "Uso: $0 <project_id> <pipeline_id>"
+  exit 1
+fi
+
+echo "Obteniendo jobs fallidos del pipeline $PIPELINE_ID..."
+
+jobs=$(curl --silent \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --url "$GITLAB_API_URL/projects/$PROJECT_ID/pipelines/$PIPELINE_ID/jobs?scope[]=failed")
+
+count=$(echo "$jobs" | jq '. | length')
+
+if [ "$count" -eq 0 ]; then
+  echo "No hay jobs fallidos"
+  exit 0
+fi
+
+echo "Encontrados $count jobs fallidos:"
+echo "$jobs" | jq -r '.[] | "  - \(.id): \(.name)"'
+echo ""
+
+read -p "¿Reintentar todos? (y/n): " confirm
+
+if [ "$confirm" != "y" ]; then
+  echo "Cancelado"
+  exit 0
+fi
+
+retried=0
+failed=0
+
+echo "$jobs" | jq -r '.[].id' | while read -r job_id; do
+  echo "Reintentando job $job_id..."
+  
+  response=$(curl --silent --write-out "HTTPSTATUS:%{http_code}" \
+    --request POST \
+    --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+    --url "$GITLAB_API_URL/projects/$PROJECT_ID/jobs/$job_id/retry")
+  
+  HTTP_STATUS=$(echo "$response" | tr -d '\n' | sed -e 's/.*HTTPSTATUS://')
+  
+  if [ "$HTTP_STATUS" -eq 201 ]; then
+    retried=$((retried + 1))
+  else
+    failed=$((failed + 1))
+  fi
+  
+  sleep 0.5
+done
+
+echo ""
+echo "Resumen:"
+echo "  ✅ Reintentados: $retried"
+echo "  ❌ Fallidos: $failed"
+```
+
+---
+
+## Scripts de Repository
+
+### Script: backup-repository.sh
+
+```bash
+#!/bin/bash
+
+# backup-repository.sh
+# Crea backup completo de un repositorio
+
+source .gitlab-env
+
+PROJECT_ID="$1"
+BACKUP_DIR="${2:-./backups}"
+
+if [ -z "$PROJECT_ID" ]; then
+  echo "Uso: $0 <project_id> [backup_dir]"
+  exit 1
+fi
+
+mkdir -p "$BACKUP_DIR"
+
+echo "Creando backup del proyecto $PROJECT_ID..."
+
+# Obtener información del proyecto
+project=$(curl --silent \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --url "$GITLAB_API_URL/projects/$PROJECT_ID")
+
+project_name=$(echo "$project" | jq -r '.path_with_namespace' | tr '/' '-')
+timestamp=$(date '+%Y%m%d-%H%M%S')
+backup_name="$project_name-$timestamp"
+backup_path="$BACKUP_DIR/$backup_name"
+
+mkdir -p "$backup_path"
+
+echo "  Nombre: $project_name"
+echo "  Backup: $backup_path"
+echo ""
+
+# 1. Clonar repositorio
+echo "1. Clonando repositorio..."
+git_url=$(echo "$project" | jq -r '.http_url_to_repo')
+git clone --mirror "$git_url" "$backup_path/repository.git"
+
+# 2. Exportar issues
+echo "2. Exportando issues..."
+page=1
+all_issues="[]"
+while true; do
+  issues=$(curl --silent \
+    --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+    --url "$GITLAB_API_URL/projects/$PROJECT_ID/issues?page=$page&per_page=100")
+  
+  count=$(echo "$issues" | jq '. | length')
+  if [ "$count" -eq 0 ]; then break; fi
+  
+  all_issues=$(echo "$all_issues" | jq ". + $issues")
+  page=$((page + 1))
+done
+echo "$all_issues" > "$backup_path/issues.json"
+
+# 3. Exportar merge requests
+echo "3. Exportando merge requests..."
+page=1
+all_mrs="[]"
+while true; do
+  mrs=$(curl --silent \
+    --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+    --url "$GITLAB_API_URL/projects/$PROJECT_ID/merge_requests?page=$page&per_page=100")
+  
+  count=$(echo "$mrs" | jq '. | length')
+  if [ "$count" -eq 0 ]; then break; fi
+  
+  all_mrs=$(echo "$all_mrs" | jq ". + $mrs")
+  page=$((page + 1))
+done
+echo "$all_mrs" > "$backup_path/merge_requests.json"
+
+# 4. Exportar pipelines (últimos 100)
+echo "4. Exportando pipelines..."
+pipelines=$(curl --silent \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --url "$GITLAB_API_URL/projects/$PROJECT_ID/pipelines?per_page=100")
+echo "$pipelines" > "$backup_path/pipelines.json"
+
+# 5. Exportar configuración del proyecto
+echo "5. Exportando configuración..."
+echo "$project" > "$backup_path/project.json"
+
+# 6. Crear archivo comprimido
+echo "6. Comprimiendo backup..."
+cd "$BACKUP_DIR"
+tar -czf "$backup_name.tar.gz" "$backup_name"
+rm -rf "$backup_name"
+
+echo ""
+echo "✅ Backup completado"
+echo "   Archivo: $BACKUP_DIR/$backup_name.tar.gz"
+```
+
+### Script: sync-files-to-repo.sh
+
+```bash
+#!/bin/bash
+
+# sync-files-to-repo.sh
+# Sincroniza archivos locales con repositorio GitLab
+
+source .gitlab-env
+
+PROJECT_ID="$1"
+LOCAL_DIR="$2"
+BRANCH="${3:-main}"
+
+if [ -z "$PROJECT_ID" ] || [ -z "$LOCAL_DIR" ]; then
+  echo "Uso: $0 <project_id> <local_dir> [branch]"
+  exit 1
+fi
+
+if [ ! -d "$LOCAL_DIR" ]; then
+  echo "❌ Directorio no encontrado: $LOCAL_DIR"
+  exit 1
+fi
+
+echo "Sincronizando archivos de $LOCAL_DIR a proyecto $PROJECT_ID..."
+echo ""
+
+# Crear commit con múltiples archivos
+actions="[]"
+
+find "$LOCAL_DIR" -type f | while read -r file; do
+  relative_path="${file#$LOCAL_DIR/}"
+  content=$(cat "$file" | base64)
+  
+  echo "  + $relative_path"
+  
+  actions=$(echo "$actions" | jq ". + [{
+    \"action\": \"create\",
+    \"file_path\": \"$relative_path\",
+    \"content\": \"$content\",
+    \"encoding\": \"base64\"
+  }]")
+done
+
+echo ""
+echo "Creando commit..."
+
+response=$(curl --silent --write-out "HTTPSTATUS:%{http_code}" \
+  --request POST \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --header "Content-Type: application/json" \
+  --data "{
+    \"branch\": \"$BRANCH\",
+    \"commit_message\": \"Sync files from local directory\",
+    \"actions\": $actions
+  }" \
+  --url "$GITLAB_API_URL/projects/$PROJECT_ID/repository/commits")
+
+HTTP_STATUS=$(echo "$response" | tr -d '\n' | sed -e 's/.*HTTPSTATUS://')
+BODY=$(echo "$response" | sed -e 's/HTTPSTATUS\:.*//g')
+
+if [ "$HTTP_STATUS" -eq 201 ]; then
+  COMMIT_ID=$(echo "$BODY" | jq -r '.id')
+  echo ""
+  echo "✅ Archivos sincronizados"
+  echo "   Commit: $COMMIT_ID"
+else
+  echo ""
+  echo "❌ Error al sincronizar"
+  echo "$BODY" | jq '.'
+  exit 1
+fi
+```
+
+---
+
+## Scripts de Monitoreo
+
+### Script: monitor-ci-status.sh
+
+```bash
+#!/bin/bash
+
+# monitor-ci-status.sh
+# Dashboard de estado de CI/CD para múltiples proyectos
+
+source .gitlab-env
+
+PROJECTS_FILE="${1:-projects.txt}"
+
+if [ ! -f "$PROJECTS_FILE" ]; then
+  echo "❌ Archivo no encontrado: $PROJECTS_FILE"
+  echo ""
+  echo "Crear archivo con IDs de proyectos (uno por línea):"
+  echo "  123"
+  echo "  456"
+  echo "  789"
+  exit 1
+fi
+
+while true; do
+  clear
+  echo "=== GitLab CI/CD Dashboard ==="
+  echo "Actualizado: $(date '+%Y-%m-%d %H:%M:%S')"
+  echo ""
+  
+  printf "%-40s %-15s %-10s %-10s\n" "PROYECTO" "ÚLTIMO PIPELINE" "ESTADO" "DURACIÓN"
+  printf "%-40s %-15s %-10s %-10s\n" "========" "===============" "======" "========"
+  
+  while read -r project_id; do
+    # Obtener proyecto
+    project=$(curl --silent \
+      --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+      --url "$GITLAB_API_URL/projects/$project_id")
+    
+    project_name=$(echo "$project" | jq -r '.name')
+    
+    # Obtener último pipeline
+    pipeline=$(curl --silent \
+      --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+      --url "$GITLAB_API_URL/projects/$project_id/pipelines?per_page=1" \
+      | jq '.[0]')
+    
+    if [ "$pipeline" != "null" ]; then
+      pipeline_id=$(echo "$pipeline" | jq -r '.id')
+      status=$(echo "$pipeline" | jq -r '.status')
+      duration=$(echo "$pipeline" | jq -r '.duration // 0')
+      
+      # Colorear estado
+      case "$status" in
+        success)
+          status_display="\033[32m$status\033[0m"
+          ;;
+        failed)
+          status_display="\033[31m$status\033[0m"
+          ;;
+        running)
+          status_display="\033[33m$status\033[0m"
+          ;;
+        *)
+          status_display="$status"
+          ;;
+      esac
+      
+      printf "%-40s %-15s %-20s %-10s\n" \
+        "$project_name" \
+        "#$pipeline_id" \
+        "$(echo -e "$status_display")" \
+        "${duration}s"
+    else
+      printf "%-40s %-15s %-10s %-10s\n" \
+        "$project_name" \
+        "N/A" \
+        "N/A" \
+        "N/A"
+    fi
+  done < "$PROJECTS_FILE"
+  
+  echo ""
+  echo "Presiona Ctrl+C para salir"
+  sleep 30
+done
+```
+
+### Script: check-pipeline-health.sh
+
+```bash
+#!/bin/bash
+
+# check-pipeline-health.sh
+# Analiza salud de pipelines de un proyecto
+
+source .gitlab-env
+
+PROJECT_ID="$1"
+DAYS="${2:-7}"
+
+if [ -z "$PROJECT_ID" ]; then
+  echo "Uso: $0 <project_id> [days]"
+  exit 1
+fi
+
+echo "Analizando pipelines de los últimos $DAYS días..."
+echo ""
+
+# Calcular fecha
+date_from=$(date -d "$DAYS days ago" '+%Y-%m-%dT00:00:00Z')
+
+# Obtener pipelines
+pipelines=$(curl --silent \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --url "$GITLAB_API_URL/projects/$PROJECT_ID/pipelines?updated_after=$date_from&per_page=100")
+
+total=$(echo "$pipelines" | jq '. | length')
+success=$(echo "$pipelines" | jq '[.[] | select(.status == "success")] | length')
+failed=$(echo "$pipelines" | jq '[.[] | select(.status == "failed")] | length')
+canceled=$(echo "$pipelines" | jq '[.[] | select(.status == "canceled")] | length')
+
+success_rate=0
+if [ "$total" -gt 0 ]; then
+  success_rate=$(echo "scale=2; $success * 100 / $total" | bc)
+fi
+
+echo "📊 Estadísticas de Pipelines"
+echo "  Total: $total"
+echo "  ✅ Exitosos: $success"
+echo "  ❌ Fallidos: $failed"
+echo "  ⏹️  Cancelados: $canceled"
+echo "  📈 Tasa de éxito: $success_rate%"
+echo ""
+
+# Duración promedio
+avg_duration=$(echo "$pipelines" | jq '[.[] | select(.duration != null) | .duration] | add / length')
+echo "⏱️  Duración promedio: ${avg_duration}s"
+echo ""
+
+# Pipelines más lentos
+echo "🐌 Top 5 pipelines más lentos:"
+echo "$pipelines" | jq -r '
+  sort_by(.duration) | reverse | .[0:5] | 
+  .[] | 
+  "  #\(.id): \(.duration)s - \(.ref)"
+'
+```
+
+---
+
+## Scripts de Automatización
+
+### Script: auto-merge-approved-mrs.sh
+
+```bash
+#!/bin/bash
+
+# auto-merge-approved-mrs.sh
+# Merge automático de MRs aprobados
+
+source .gitlab-env
+
+PROJECT_ID="$1"
+MIN_APPROVALS="${2:-2}"
+
+if [ -z "$PROJECT_ID" ]; then
+  echo "Uso: $0 <project_id> [min_approvals]"
+  exit 1
+fi
+
+echo "Buscando MRs listos para merge..."
+echo "  Aprobaciones mínimas: $MIN_APPROVALS"
+echo ""
+
+# Obtener MRs abiertos
+mrs=$(curl --silent \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --url "$GITLAB_API_URL/projects/$PROJECT_ID/merge_requests?state=opened")
+
+merged=0
+skipped=0
+
+echo "$mrs" | jq -c '.[]' | while read -r mr; do
+  iid=$(echo "$mr" | jq -r '.iid')
+  title=$(echo "$mr" | jq -r '.title')
+  
+  # Obtener detalles de aprobación
+  approvals=$(curl --silent \
+    --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+    --url "$GITLAB_API_URL/projects/$PROJECT_ID/merge_requests/$iid/approvals")
+  
+  approved_count=$(echo "$approvals" | jq -r '.approved_by | length')
+  pipeline_status=$(echo "$mr" | jq -r '.pipeline.status // "none"')
+  has_conflicts=$(echo "$mr" | jq -r '.has_conflicts')
+  
+  echo "MR !$iid: $title"
+  echo "  Aprobaciones: $approved_count/$MIN_APPROVALS"
+  echo "  Pipeline: $pipeline_status"
+  echo "  Conflicts: $has_conflicts"
+  
+  # Verificar criterios
+  if [ "$approved_count" -ge "$MIN_APPROVALS" ] && \
+     [ "$pipeline_status" = "success" ] && \
+     [ "$has_conflicts" = "false" ]; then
+    
+    echo "  ✅ Mergeando..."
+    
+    curl --silent \
+      --request PUT \
+      --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+      --header "Content-Type: application/json" \
+      --data '{"should_remove_source_branch": true}' \
+      --url "$GITLAB_API_URL/projects/$PROJECT_ID/merge_requests/$iid/merge" \
+      > /dev/null
+    
+    merged=$((merged + 1))
+  else
+    echo "  ⏭️  Omitiendo"
+    skipped=$((skipped + 1))
+  fi
+  
+  echo ""
+done
+
+echo "Resumen:"
+echo "  ✅ Mergeados: $merged"
+echo "  ⏭️  Omitidos: $skipped"
+```
+
+### Script: cleanup-old-branches.sh
+
+```bash
+#!/bin/bash
+
+# cleanup-old-branches.sh
+# Limpia branches viejos y mergeados
+
+source .gitlab-env
+
+PROJECT_ID="$1"
+DAYS_OLD="${2:-30}"
+
+if [ -z "$PROJECT_ID" ]; then
+  echo "Uso: $0 <project_id> [days_old]"
+  exit 1
+fi
+
+echo "Buscando branches antiguos (>$DAYS_OLD días)..."
+echo ""
+
+# Obtener branches
+branches=$(curl --silent \
+  --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+  --url "$GITLAB_API_URL/projects/$PROJECT_ID/repository/branches")
+
+# Fecha límite
+cutoff_date=$(date -d "$DAYS_OLD days ago" '+%s')
+
+to_delete=()
+
+echo "$branches" | jq -c '.[]' | while read -r branch; do
+  name=$(echo "$branch" | jq -r '.name')
+  merged=$(echo "$branch" | jq -r '.merged')
+  commit_date=$(echo "$branch" | jq -r '.commit.committed_date')
+  
+  # Skip protected branches
+  if [ "$name" = "main" ] || [ "$name" = "master" ] || [ "$name" = "develop" ]; then
+    continue
+  fi
+  
+  # Convertir fecha
+  commit_timestamp=$(date -d "$commit_date" '+%s')
+  
+  # Verificar si es antiguo y mergeado
+  if [ "$commit_timestamp" -lt "$cutoff_date" ] && [ "$merged" = "true" ]; then
+    echo "  🗑️  $name (último commit: $commit_date)"
+    to_delete+=("$name")
+  fi
+done
+
+if [ ${#to_delete[@]} -eq 0 ]; then
+  echo "No hay branches para eliminar"
+  exit 0
+fi
+
+echo ""
+echo "Se eliminarán ${#to_delete[@]} branches"
+read -p "¿Continuar? (y/n): " confirm
+
+if [ "$confirm" != "y" ]; then
+  echo "Cancelado"
+  exit 0
+fi
+
+deleted=0
+for branch in "${to_delete[@]}"; do
+  echo "Eliminando $branch..."
+  
+  curl --silent \
+    --request DELETE \
+    --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
+    --url "$GITLAB_API_URL/projects/$PROJECT_ID/repository/branches/$(echo "$branch" | sed 's|/|%2F|g')" \
+    > /dev/null
+  
+  deleted=$((deleted + 1))
+  sleep 0.3
+done
+
+echo ""
+echo "✅ Eliminados $deleted branches"
+```
+
+---
+
+**Nota**: Todos estos scripts requieren:
+1. Archivo `.gitlab-env` con variables de entorno
+2. Permisos adecuados en GitLab
+3. `jq` instalado para procesamiento JSON
+4. `curl` para llamadas API
+
+Para usar los scripts:
+```bash
+# 1. Configurar entorno
+./setup-gitlab-env.sh
+
+# 2. Cargar variables
+source .gitlab-env
+
+# 3. Ejecutar scripts
+./list-all-projects.sh
+./create-issue-from-template.sh 123 issues.csv
+./monitor-pipeline.sh 123 456
+```