Xử lý sự cố
Các vấn đề thường gặp ở bất kỳ đâu trong Container Registry, nhóm theo nơi xảy ra trong workflow. Nếu vấn đề của bạn không có trong danh sách, liên hệ Tenant Owner hoặc Sales.
Kích hoạt dịch vụ
| Issue | Cause | Resolution |
|---|---|---|
| Không thấy nút Active | Bạn không phải Tenant Owner. | Chọn tenant mà bạn có role Owner, hoặc nhờ Tenant Owner kích hoạt dịch vụ. |
| Không tìm thấy thông tin đăng nhập sau khi kích hoạt | Thông tin đăng nhập, lệnh tag, và push chỉ hiện khi hover icon ⓘ trên màn kết quả kích hoạt. | Hover lại icon ⓘ, hoặc lấy thông tin mới ở Container Registry > Get Token. |
Xem Kích hoạt dịch vụ.
Quản lý repository, artifact, và tag
| Issue | Cause | Resolution |
|---|---|---|
| Đã xóa nhầm 1 Repository, Artifact, hoặc Tag và không lấy lại được | Xóa là vĩnh viễn theo thiết kế — không có undo. | Xác nhận không còn cần resource trước khi nhấn Delete lần sau. Push lại image nếu vẫn cần. |
Xem Quản lý Repository.
Quản lý Retention Rule
| Issue | Cause | Resolution |
|---|---|---|
| Đã xóa 1 Retention Rule và rule biến mất | Xóa Retention Rule là vĩnh viễn, rule không còn áp dụng cho các lần chạy sau. | Xác nhận trước khi xóa. Tạo rule mới nếu cần lại tiêu chí tương tự. |
| Không đặt được giờ chạy riêng cho từng Retention Rule | 1 Schedule áp dụng cho mọi Retention Rule trong Policy — không thể cấu hình schedule riêng cho từng rule. | Dùng 1 Schedule chung cho mọi rule, hoặc chạy riêng 1 rule bằng RUN NOW hoặc DRY RUN. |
Xem Quản lý Retention Rule & run.
Quản lý Robot Account
| Issue | Cause | Resolution |
|---|---|---|
| Đã xóa 1 Robot Account và CI/CD ngừng hoạt động | Xóa Robot Account là vĩnh viễn, CI/CD pipeline dùng account đó mất quyền truy cập ngay. | Xác nhận trước khi xóa. Tạo Robot Account mới và cập nhật cấu hình CI/CD nếu vẫn cần quyền truy cập. |
| Mất Username hoặc Token của Robot Account sau khi tạo | Username và Token chỉ hiển thị 1 lần, ngay sau khi tạo. | Dùng ACTION REFRESH SECRET để tạo Token mới, rồi cập nhật ở mọi nơi dùng Robot Account này. |
docker login, docker pull, hoặc docker push trả lỗi "unauthorized to access repository" | Robot Account đã bị disable, xóa, hoặc Token đã hết hạn. | Bật lại account, tạo account mới, hoặc refresh secret, rồi cập nhật thông tin xác thực ở mọi nơi dùng Robot Account này. |
| CI/CD xác thực thất bại sau khi refresh secret của Robot Account | Secret cũ vẫn còn cấu hình trong pipeline hoặc hệ thống. | Cập nhật secret mới trong mọi pipeline và hệ thống dùng Robot Account này ngay. |
Xem Tạo Robot Account và Quản lý Robot Account.
Quản lý service package & quota
| Issue | Cause | Resolution |
|---|---|---|
| Không hạ cấp được xuống Service Plan thấp hơn | Container Registry chỉ hỗ trợ nâng cấp — không hỗ trợ hạ cấp. | Liên hệ Sales nếu plan hiện tại không còn phù hợp với tier cao hơn. |
| Service Plan cần dùng không có trong Update Type | Self-service upgrade chỉ hiện các plan chuẩn. | Liên hệ Sales để được hỗ trợ Service Plan cao hơn hoặc tùy chỉnh. |
Xem Quản lý service package & quota.
Pull image vào cluster bằng kubectl
| Issue | Cause | Resolution |
|---|---|---|
ImagePullBackOff, Events hiện 401 Unauthorized | --docker-server không khớp host trong tên image, hoặc thông tin đăng nhập sai. | Decode Secret và so khớp phần auths với host trong tên image. |
ImagePullBackOff, Events hiện not found | Tên image hoặc tag sai. | Kiểm tra image có tồn tại trên registry không. |
| Secret có vẻ đúng nhưng Pod vẫn lỗi | Pod chưa khai báo imagePullSecrets, hoặc khác namespace với Secret. | Thêm imagePullSecrets vào Pod template, và đảm bảo Secret cùng namespace với Pod. |
Error from server (AlreadyExists) | Secret đã tồn tại — kubectl create không ghi đè. | Pipe lệnh qua kubectl apply để có thể chạy lại an toàn. |
Khối auths rỗng sau khi decode Secret | Docker đang lưu thông tin đăng nhập trong keychain hệ điều hành ("credsStore" trong config.json) thay vì khối auths. | Tạo lại Secret trực tiếp bằng kubectl create secret docker-registry. |
Password đúng nhưng vẫn 401 | Shell đã làm thay đổi ký tự đặc biệt trong password. | Bọc password trong nháy đơn và tạo lại Secret. |
Error from server (Forbidden) | Thiếu quyền RBAC. | Chạy kubectl auth can-i create secret -n <namespace> để kiểm tra. |