Repository information

Cada repositorio puede incluir una descripción, una vista general y categorías para ayudar a los usuarios a comprender su propósito y uso. Agregar información clara del repositorio garantiza que otros puedan encontrar tus imágenes y usarlas de manera efectiva.

Solo puedes modificar la información de los repositorios que no estén archivados. Si un repositorio está archivado, debes desarchivarlo para modificar la información. Para obtener más detalles, consulta Desarchivar un repositorio.

Descripción del repositorio

La descripción aparece en los resultados de búsqueda al utilizar el comando docker search y en los resultados de búsqueda en Docker Hub.

Considera las siguientes mejores prácticas para la descripción del repositorio.

• Resumir el propósito. Explica claramente qué hace la imagen de manera concisa y específica. Deja claro si es para una aplicación, herramienta o plataforma en particular, o si tiene un caso de uso específico.
• Destacar características o beneficios clave. Menciona brevemente los beneficios principales o características únicas que diferencian la imagen. Los ejemplos incluyen alto rendimiento, facilidad de uso, compilación ligera o compatibilidad con frameworks o sistemas operativos específicos.
• Incluir palabras clave relevantes. Utiliza palabras clave que los usuarios puedan buscar para aumentar la visibilidad, como pilas tecnológicas, casos de uso o entornos.
• Mantenerlo conciso. La descripción puede tener un máximo de 100 caracteres. Intenta limitarte a una o dos oraciones para la descripción para garantizar que sea fácil de leer en los resultados de búsqueda. Los usuarios deben comprender rápidamente el valor de la imagen.
• Enfocarse en la audiencia. Considera a tu público objetivo (desarrolladores, administradores de sistemas, etc.) y escribe la descripción para abordar sus necesidades directamente.

Seguir estas prácticas puede ayudar a que la descripción sea más atractiva y efectiva en los resultados de búsqueda, atrayendo más tráfico relevante a tu repositorio.

Añadir o actualizar la descripción de un repositorio

1. Inicia sesión en Docker Hub.

2. Selecciona My Hub > Repositories.

   Aparece una lista de tus repositorios.

3. Selecciona un repositorio.

   Aparece la página General del repositorio.

4. Selecciona el icono del lápiz debajo del campo de descripción.

5. Especifica una descripción.

   La descripción puede tener hasta 100 caracteres de longitud.

6. Selecciona Update.

Vista general del repositorio (Repository overview)

Una vista general describe lo que hace tu imagen y cómo ejecutarla. Se muestra en la vista pública de tu repositorio cuando este tiene al menos una imagen. Si las builds automáticas están habilitadas, la vista general se sincronizará desde el archivo README.md del repositorio de código fuente en cada compilación exitosa.

Considera las siguientes mejores prácticas para la vista general del repositorio.

• Describe qué es la imagen, las características que ofrece y por qué debería usarse. Puede incluir ejemplos de uso o el equipo detrás del proyecto.
• Explica cómo comenzar a ejecutar un contenedor utilizando la imagen. Puedes incluir un ejemplo mínimo de cómo usar la imagen en un Dockerfile.
• Enumera las variantes clave de la imagen y las etiquetas para usarlas, así como los casos de uso para las variantes.
• Enlaza a la documentación o sitios de soporte, comunidades o listas de correo para obtener recursos adicionales.
• Proporciona información de contacto para los mantenedores de la imagen.
• Incluye la licencia de la imagen y dónde encontrar más detalles si es necesario.

Añadir o actualizar la vista general de un repositorio

1. Inicia sesión en Docker Hub.

2. Selecciona My Hub > Repositories.

   Aparece una lista de tus repositorios.

3. Selecciona un repositorio.

   Aparece la página General del repositorio.

4. En Repository overview, selecciona Edit o Add overview.

   Aparecen las pestañas Write y Preview.

5. En Write, especifica la vista general de tu repositorio.

   Puedes utilizar Markdown básico y la pestaña Preview para previsualizar el formato.

6. Selecciona Update.

Categorías del repositorio

Puedes etiquetar los repositorios de Docker Hub con categorías, que representan los casos de uso principales previstos para tus imágenes. Esto permite a los usuarios encontrar y explorar con mayor facilidad el contenido para el dominio del problema en el que están interesados.

Categorías disponibles

El equipo de contenido de Docker Hub mantiene una lista curada de categorías.

Las categorías incluyen:

• Gestión de API: Herramientas para crear, publicar, analizar y proteger API.
• Sistemas de gestión de contenidos (CMS): Aplicaciones de software para crear y gestionar contenido digital mediante plantillas, procedimientos y formatos estándar.
• Ciencia de datos: Herramientas y software para apoyar el análisis de datos y generar información accionable.
• Herramientas de desarrollo: Software y utilidades que ayudan a los desarrolladores a crear, depurar, mantener y dar soporte a aplicaciones y sistemas.
• Bases de datos y almacenamiento: Sistemas para almacenar, recuperar y gestionar datos.
• Lenguajes y frameworks: Entornos de ejecución y frameworks de lenguajes de programación.
• Integración y entrega: Herramientas para integración continua (CI) y entrega continua (CD).
• Internet de las cosas: Herramientas compatibles con aplicaciones de Internet de las cosas (IoT).
• Aprendizaje automático e IA: Herramientas y frameworks optimizados para proyectos de inteligencia artificial y aprendizaje automático, como bibliotecas y frameworks preinstalados para el análisis de datos, el entrenamiento de modelos y el despliegue.
• Colas de mensajes: Sistemas de colas de mensajes optimizados para un manejo de mensajes confiable, escalable y eficiente.
• Monitoreo y observabilidad: Herramientas para realizar el seguimiento del rendimiento del software y del sistema a través de métricas, registros y trazas, así como observabilidad para explorar el estado del sistema y diagnosticar problemas.
• Redes: Repositorios que admiten el intercambio de datos y la conexión de computadoras y otros dispositivos para compartir recursos.
• Sistemas operativos: Software que administra todos los demás programas en una computadora y sirve como intermediario entre los usuarios y el hardware de la computadora, al mismo tiempo que supervisa las aplicaciones y los recursos del sistema.
• Seguridad: Herramientas para proteger un sistema informático o una red contra robos, accesos no autorizados o daños a su hardware, software o datos electrónicos, así como contra la interrupción del servicio.
• Servidores web: Software para servir páginas web, archivos HTML y otros recursos a usuarios u otros sistemas.
• Analítica web: Herramientas para recopilar, medir, analizar e informar sobre datos web y la interacción de los visitantes del sitio web.

Categorías autogeneradas

Note

Las categorías autogeneradas solo se aplican a los Docker Verified Publishers y a los participantes del programa Docker-Sponsored Open Source.

Para los repositorios que son anteriores a la función de Categorías en Docker Hub, las categorías se han generado y aplicado automáticamente, utilizando OpenAI, en función del título y la descripción del repositorio.

Como propietario de un repositorio que ha sido autocategorizado, puedes editar manualmente las categorías si crees que son inexactas. Consulta Gestionar categorías para un repositorio.

La categorización autogenerada fue un esfuerzo único para ayudar a sembrar categorías en repositorios creados antes de que existiera la función. Las categorías no se asignan a los nuevos repositorios automáticamente.

Gestionar categorías para un repositorio

Puedes etiquetar un repositorio con hasta tres categorías.

Para editar las categorías de un repositorio:

1. Inicia sesión en Docker Hub.

2. Selecciona My Hub > Repositories.

   Aparece una lista de tus repositorios.

3. Selecciona un repositorio.

   Aparece la página General del repositorio.

4. Selecciona el icono del lápiz debajo del campo de descripción.

5. Selecciona las categorías que quieres aplicar.

6. Selecciona Update.

Si falta alguna categoría, utiliza el enlace para enviar comentarios para sugerir qué categorías te gustaría ver.