kloudedocs
Browse documentation
On this page

PRODUCT GUIDE

Registry

Use the Kloude container registry in the portal: organization overview, access tokens, docker login with placeholders, public library cache, and push/pull for cluster deploys.

The container registry stores your organization images. Push app images here, create scoped tokens for CI, and use the Docker Hub pull-through cache when it is enabled. That is handy for deploys onto Kloude managed Kubernetes.

In the portal, Registry has tabs for Overview, Public library, Connection, Images, and Access tokens, plus a side Registry guide.

What you see in the panel

Overview shows your organization space (private/public toggle), registry host https://registry.kloude.ir, and counts for repositories and tokens.

Public library lists popular Docker Hub images (nginx, php, node, and similar). The first pull can be cached on your registry.

Access tokens are for docker login and CI only, not for signing into a Harbor UI. Create tokens when the list is empty.

The create dialog asks for an optional name (for example ci-push), a Push permission checkbox, and reminds you the secret is shown once.

When to use it

Keep private images for Kubernetes deploys, give CI/CD a limited token for docker push and pull, and cut repeated pulls of popular public images through the proxy cache.

Tutorial: token, login, push

Open Registry

Select Registry in the portal navigation and review Overview so you know your org path and that the space is private unless you intentionally switch it.

Create an access token

Open Access tokens → Create token. Optional name, enable push only if the pipeline must push, then create. Copy the secret immediately; it is shown once.

Follow Connection with placeholders

Open Connection. Authenticate with your robot username and secret. Use placeholders in shared docs:

bash
docker login https://registry.kloude.ir -u 'robot$ci' -p '<secret>'
bash
docker tag myapp:latest registry.kloude.ir/your-org/myapp:latest docker push registry.kloude.ir/your-org/myapp:latest docker pull registry.kloude.ir/your-org/myapp:latest

Optional: pull from Public library

Browse Public library, copy a pull command, and confirm cache behavior for your org.

Deploy to the cluster

Reference the image in a Deployment or Pod. Create a pull secret in the cluster when the repository is private. Rotate tokens when people or pipelines change.