Inicio rápido del Registry
Un Zaroz Registry guarda tus imágenes de contenedor junto al lugar donde corren tus Workloads. Subes una imagen con Docker y un Workload de la misma organización la descarga sin configuración extra. Esta página te lleva de cero a una imagen en marcha. Para subir desde una pipeline en lugar de tu portátil, mira Subir desde CI.
1. Crea el registro
- En la consola, abre tu proyecto y elige Registry.
- Compra un registro. Es una suscripción por registro y el precio se muestra antes de pagar.
- Ábrelo. Un registro nuevo aún no usa almacenamiento y la página ofrece Crear registro. Confirma.
La página del registro muestra su host de acceso: la dirección que le das a docker login. Las imágenes viven bajo el espacio de nombres de tu registro, así que un nombre de imagen completo tiene esta forma:
Code
La consola muestra el prefijo exacto (<host de acceso>/<espacio de nombres>) en la pestaña Repositorios; cópialo de ahí.
2. Crea una credencial
Un registro no tiene contraseñas propias. Creas credenciales, una por persona o pipeline, de modo que revocar una nunca afecta a las demás.
- Abre la pestaña Acceso y elige Nueva credencial.
- Ponle un nombre como
portatilociy elige un alcance:
| Alcance | Qué puede hacer |
|---|---|
| Solo pull | docker pull |
| Pull y push | docker pull y docker push |
| Pull, push y borrado | lo anterior, y borrar etiquetas y repositorios |
- Copia el usuario y el secreto. El secreto se muestra una sola vez. Zaroz guarda solo un hash y no puede mostrarlo de nuevo; si lo pierdes, revoca la credencial y crea otra.
Un registro puede tener hasta veinte credenciales activas. Usa el alcance más estrecho que funcione: un portátil que solo despliega necesita pull y push, un servidor que solo ejecuta la imagen necesita pull.
3. Inicia sesión, sube y descarga
Code
Crear un repositorio no necesita un paso propio: el primer push a mi-app lo crea. Los nombres de repositorio pueden tener varias partes (web/api), con minúsculas, dígitos, ., _ y -.
Si docker login responde Invalid registry credentials, el secreto es incorrecto o la credencial fue revocada. Un token que Docker ya tiene sigue funcionando unos minutos después de revocar una credencial.
4. Etiquetas y limpieza
Abre la pestaña Etiquetas y elige un repositorio. Cada etiqueta muestra su digest, su tamaño y cuándo se construyó la imagen. El registro no guarda el momento del push, así que la fecha es la de construcción guardada en la imagen.
- Copiar comando de pull pone
docker pull <imagen>en tu portapapeles. - Eliminar borra una etiqueta tras una confirmación. Quien descargue esa etiqueta recibirá un error a partir de entonces. La imagen sigue disponible bajo cualquier otra etiqueta que apunte a ella.
Eliminar una etiqueta no libera espacio al instante. El registro quita las capas que ninguna etiqueta usa en una pasada de limpieza (recolección de basura), así que el tamaño almacenado baja un tiempo después de borrar. Lo mismo vale para borrar un repositorio entero desde la pestaña Repositorios.
Las etiquetas antiguas siguen contando en tu tamaño almacenado. Un buen hábito es una etiqueta inmutable por construcción (el hash del commit) más una etiqueta móvil como latest, y una limpieza periódica de las etiquetas de construcciones viejas.
Desde la API, las mismas dos operaciones son GET y DELETE sobre /subscriptions/{id}/registry/repositories/tags con la path del repositorio (por ejemplo mi-app) y, para borrar, la tag. Un repositorio con muchísimas etiquetas lista solo las primeras y lo indica.
5. Usa la imagen en un Workload
En el origen del Workload, pon la imagen <host de acceso>/<espacio de nombres>/mi-app:1.0.0 y despliega, como en Despliega un Workload desde una imagen pública.
No añades un inicio de sesión de registro al Workload. Cuando la imagen viene de un Zaroz Registry que pertenece a la misma organización que el Workload, Zaroz da al clúster una credencial propia de solo pull y la mantiene al día. No gasta una de tus veinte credenciales y nunca aparece en tu lista.
Eso solo funciona con tu propio registro. Una imagen del registro de otra organización, o de cualquier otro registro privado, necesita un inicio de sesión de pull en el origen del Workload como siempre.
Límites y facturación
| Tope de almacenamiento | 100 GiB por defecto; puedes fijarlo entre 1 GiB y 100 TiB |
| Credenciales | hasta 20 activas por registro |
| Registros | uno por suscripción |
El almacenamiento se factura por GB-mes, promediado durante el mes, como el almacenamiento de objetos. Se mide en bytes lógicos: lo que tú subiste, contando cada capa una vez dentro de tu registro, como si no se compartiera nada con nadie más. Una capa que comparten dos de tus imágenes cuenta una vez; la misma capa en el registro de otro cliente nunca cambia tu factura.
La salida de datos (egress) se factura por GB que salen de la red de Zaroz, no por pull. Tus propios Workloads en Zaroz descargando tus imágenes son gratis y ni siquiera se miden. El almacenamiento se factura desde el principio; mira el precio en la página de pago para saber si la línea de egress está activa en tu región.
Cuando el tamaño almacenado supera el tope, el registro pasa a solo lectura: los pulls siguen funcionando y los push se rechazan hasta que borres etiquetas o subas el tope. Si la suscripción termina, el registro se programa para borrarse y sus imágenes se pueden recuperar durante siete días.