ایمیج‌های کانتینر

**ایمیج کانتینر** برنامه را با هر چه برای اجرا لازم دارد بسته‌بندی می‌کند. زرین یک رجیستری کانتینر است: `docker push` و `docker pull` (و podman، buildah، nerdctl و Kubernetes) مستقیم با آن کار می‌کنند. نام رجیستری در [بسته‌ها](/packages) زیر **Docker** نشان داده می‌شود؛ در zaryn.xyz همان `zaryn.xyz` است. ایمیج‌ها این‌طور نام می‌گیرند: `zaryn.xyz/<owner>/<image>:<tag>`، که `<owner>` نام کاربری شما یا سازمانی است که مالک یا مدیرش هستید. ## ورود (یک بار برای هر رایانه) در [بسته‌ها](/packages) توکن بسازید (**ساخت توکن انتشار**)، سپس: ```bash echo YOUR_TOKEN | docker login zaryn.xyz -u your-username --password-stdin ``` ## فرستادن (push) ```bash docker build -t zaryn.xyz/your-username/app:1.0 . docker push zaryn.xyz/your-username/app:1.0 ``` - `-t` به ایمیج نام می‌دهد: رجیستری، مالک، نام ایمیج، و پس از دونقطه یک *tag* (یک نسخه، یا `latest`). - لایه‌هایی که زرین از قبل دارد دوباره بارگذاری نمی‌شوند. ## گرفتن (pull) ```bash docker pull zaryn.xyz/your-username/app:1.0 ``` ایمیج‌های عمومی برای pull به ورود نیاز ندارند. ## Kubernetes برای ایمیج خصوصی، به جای توکن خودتان یک کلید فقط‌خواندنی به کلاستر بدهید: در زرین یک کلید API پروژه بسازید، سپس ```bash kubectl create secret docker-registry zaryn \ --docker-server=zaryn.xyz --docker-username=zaryn \ --docker-password=YOUR_PROJECT_KEY ``` و `imagePullSecrets: [{ name: zaryn }]` را به مشخصات pod اضافه کنید. این کلید فقط می‌تواند pull کند و هر وقت بخواهید باطلش می‌کنید. ## چارت‌های Helm و فایل‌های دیگر هر چیزی در قالب OCI کنار ایمیج‌ها نگه داشته می‌شود: ```bash helm push chart-0.1.0.tgz oci://zaryn.xyz/your-username/charts oras push zaryn.xyz/your-username/model:v1 model.gguf ``` امضاها و SBOMها (از cosign و ابزارهای مشابه) به ایمیجی که توصیفش می‌کنند وصل می‌شوند و در صفحه‌اش دیده می‌شوند. ## ایمیج‌های خصوصی (پریمیوم) در پریمیوم ایمیج‌های تازه خصوصی شروع می‌شوند؛ هر ایمیج را در صفحه‌اش عوض کنید. در طرح رایگان ایمیج‌ها عمومی‌اند. | | رایگان | پریمیوم | |---|---|---| | بزرگ‌ترین لایه | ۵۰۰ مگابایت | ۱۰ گیگابایت | | فضا (بسته‌ها و ایمیج‌ها با هم) | ۵۰۰ مگابایت | ۱۰۰ گیگابایت | ## وقتی چیزی درست کار نمی‌کند | docker می‌گوید | یعنی | راه‌حل | |---|---|---| | `unauthorized` | وارد نشده‌اید، یا توکن منقضی شده | دوباره `docker login zaryn.xyz` | | `denied` | آن مالک شما یا سازمانتان نیست | زیر نام کاربری خودتان push کنید | | بارگذاری یک لایه به خاطر اندازه رد می‌شود | لایه از حد طرحتان بزرگ‌تر است | ایمیج را کوچک‌تر کنید (ساخت چندمرحله‌ای)، یا ارتقا دهید |