febrero 2024

swagger

Se puede usar para gestionar documentos diseñados en desarrollo de APIs. Genera código de ejemplo en JSON y funciona de manera similar a Postman.

Cada vez se usa más en los proyectos actuales.

Iniciar servidor localmente (el ejemplo tiene 3 instancias, para casos con 3 servidores API externos, etc.)

docker pull swaggerapi/swagger-editor
docker run -d -p 8090:8080 swaggerapi/swagger-editor
docker run -d -p 8091:8080 swaggerapi/swagger-editor
docker run -d -p 8092:8080 swaggerapi/swagger-editor

Abre http://localhost:8090 en el navegador.

Copia y pega el contenido del archivo yaml del repositorio en la ventana izquierda del navegador junto con el control de código fuente.

Realiza pruebas con get, post, etc.

※ Como es una API, necesitas entender la especificación en cierta medida.

La herramienta que se usa frecuentemente junto con esto es OpenAPI

Esta es una herramienta que carga un archivo yaml (archivo de diseño de API) y genera automáticamente el código fuente de las partes I/O en el idioma especificado. Sin embargo, no todo es positivo; a menudo genera código incorrecto también, así que te encontrarás en situaciones donde necesitas hacer limpieza de código problemático.

Error en el comando dnf

dnf update

AlmaLinux 8 - BaseOS 485 kB/s | 3.4 kB 00:00 
GPG 鍵 0xC21AD6EA をインポート中: 
Userid : "AlmaLinux <packager@almalinux.org>" 
Fingerprint: E53C F5EF 91CE B0AD 1812 ECB8 51D6 647E C21A D6EA 
From : /etc/pki/rpm-gpg/RPM-GPG-KEY-AlmaLinux 
これでよろしいですか? [y/N]: y 
鍵のインポートに成功しました 
鍵をインポートしても役に立ちませんでした。鍵が間違っていませんか?

La clave se actualizó

Actualización de clave GPG de AlmaLinux 8

A partir del 12 de enero de 2024, los paquetes RPM y los metadatos del repositorio de AlmaLinux 8 se firmarán con una clave GPG actualizada. Ejecutando los pasos siguientes, podrás seguir recibiendo actualizaciones sin problemas después del cambio.

Si deseas confirmar que tu sistema ya contiene la nueva clave GPG de AlmaLinux 8 y que confía en ella, simplemente importala.

sudo rpm --import https://repo.almalinux.org/almalinux/RPM-GPG-KEY-AlmaLinux

Intenté acceder desde el navegador a

http://localhost:8081

con las credenciales especificadas:

ME_CONFIG_MONGODB_ADMINUSERNAME: root 
ME_CONFIG_MONGODB_ADMINPASSWORD: password

Pero no funcionaba. Resulta que necesitaba agregar variables de entorno para la autenticación básica del navegador:

ME_CONFIG_BASICAUTH_USERNAME: admin
ME_CONFIG_BASICAUTH_PASSWORD: password

Crear el archivo «docker-compose.yml» (código abajo)
Ejecutar «docker-compose up -d» en la terminal

version: '3.1'

services:

  mongo:
    container_name: mongo-dev
    image: mongo
    restart: always
    ports:
      - "27017:27017"
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: password
    volumes:
      - ./configdb:/data/configdb
      - mongoDataStore:/data/db

  mongo-express:
    container_name: mongo-express
    image: mongo-express
    restart: always
    ports:
      - 8081:8081
    environment:
      ME_CONFIG_MONGODB_ADMINUSERNAME: root
      ME_CONFIG_MONGODB_ADMINPASSWORD: password
      ME_CONFIG_MONGODB_URL: mongodb://root:password@mongo:27017/
      ME_CONFIG_BASICAUTH_USERNAME: admin
      ME_CONFIG_BASICAUTH_PASSWORD: password

volumes:
  mongoDataStore:
    driver: local

Verificar la conexión desde la terminal de Mac (crear testDB previamente desde express):

mongosh "mongodb://root:password@localhost:27017/testDB?authSource=admin"

Current Mongosh Log ID: 65be609e7384r68762b10b0