fix: 部署管理：拉取不到镜像时体验优化 (#2244)

Author: xogas

apiserver/paasng/locale/en/LC_MESSAGES/django.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-06-27 18:06+0800\n"
+"POT-Creation-Date: 2025-07-04 14:01+0800\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -200,30 +200,44 @@ msgstr "Bound module information"
 msgid "显示名称"
 msgstr "Display name"
 
-#: paas_wl/bk_app/cnative/specs/views.py:119
+#: paas_wl/bk_app/cnative/specs/views.py:120
 msgid "权限不足或仓库不可达"
 msgstr "Insufficient permissions or repository unreachable"
 
-#: paas_wl/bk_app/cnative/specs/views.py:141
+#: paas_wl/bk_app/cnative/specs/views.py:142
 msgid "镜像凭证不存在"
 msgstr "Image credentials not found"
 
-#: paas_wl/bk_app/cnative/specs/views.py:158
+#: paas_wl/bk_app/cnative/specs/views.py:153
+msgid "镜像仓库不存在，请检查仓库地址是否正确"
+msgstr "Image repository not exist, please check whether the repository address is correct."
+
+#: paas_wl/bk_app/cnative/specs/views.py:155
+msgid "镜像仓库权限不足, 请检查是否配置镜像凭证"
+msgstr ""
+"Image repository has no permission, please check whether the image "
+"credentials are configured."
+
+#: paas_wl/bk_app/cnative/specs/views.py:157
+msgid "镜像仓库凭证错误, 请检查镜像凭证配置是否正确"
+msgstr ""
+"Image repository credential verification failed, please check the credential is "
+"correctly."
+
+#: paas_wl/bk_app/cnative/specs/views.py:165
 msgid "查看镜像 Tag"
 msgstr "View image Tag"
 
-#: paas_wl/bk_app/cnative/specs/views.py:166
-#: paasng/platform/sourcectl/views.py:418
-#, python-format
-msgid "%s的仓库信息查询异常"
-msgstr "The warehouse information query of %s is abnormal"
+#: paas_wl/bk_app/cnative/specs/views.py:173
+msgid "拉取镜像 Tag 失败"
+msgstr "Failed to list tag from image repository"
 
-#: paas_wl/bk_app/cnative/specs/views.py:223
-#: paas_wl/bk_app/cnative/specs/views.py:282
+#: paas_wl/bk_app/cnative/specs/views.py:230
+#: paas_wl/bk_app/cnative/specs/views.py:289
 msgid "同环境和路径挂载卷已存在"
 msgstr "Mount volume already exists in the same environment and path."
 
-#: paas_wl/bk_app/cnative/specs/views.py:373
+#: paas_wl/bk_app/cnative/specs/views.py:380
 msgid "当前应用暂不支持持久存储功能，请联系管理员"
 msgstr ""
 "The current application does not support persistent storage functionality. "
@@ -768,9 +782,9 @@ msgstr "Other"
 #: paasng/platform/engine/constants.py:127
 #: paasng/platform/engine/workflow/protections.py:68
 #, fuzzy
-#| msgid "未完善应用市场信息"
+#| msgid "未完善应用基本信息"
 msgid "未完善应用市场信息"
-msgstr "Incomplete app market information"
+msgstr "Incomplete app basic information"
 
 #: paasng/accessories/publish/market/protections.py:66
 msgid "应用未在生产环境成功部署"
@@ -2310,26 +2324,30 @@ msgstr "Testing in progress"
 msgid "无法获取到有效的配置信息."
 msgstr "No valid configuration information is available."
 
-#: paasng/plat_mgt/applications/serializers/application.py:188
+#: paasng/plat_mgt/applications/serializers/application.py:209
 #, python-brace-format
 msgid "于{time}{operation}{status}"
 msgstr " {operation} {status} at {time}"
 
-#: paasng/plat_mgt/applications/serializers/application.py:239
+#: paasng/plat_mgt/applications/serializers/application.py:252
+msgid "应用分类不存在"
+msgstr ""
+
+#: paasng/plat_mgt/applications/serializers/application.py:274
 #, python-brace-format
 msgid "现有的分配策略下未找到匹配的集群(集群名: {name})"
 msgstr ""
 "No matching cluster was found under the existing allocation strategy "
 "(cluster name: {name})"
 
-#: paasng/plat_mgt/applications/views/application.py:305
+#: paasng/plat_mgt/applications/views/application.py:330
 #, fuzzy
 #| msgid "应用不存在"
 msgid "应用不存在或未被软删除"
 msgstr "application does not exist"
 
-#: paasng/plat_mgt/applications/views/application.py:313
-msgid "PaaS 2.0 中信息删除失败，无法硬删除应用"
+#: paasng/plat_mgt/applications/views/application.py:338
+msgid "PaaS 2.0 中信息删除失败"
 msgstr ""
 
 #: paasng/plat_mgt/applications/views/services.py:153
@@ -3483,7 +3501,7 @@ msgstr ""
 #: paasng/platform/mgrlegacy/app_migrations/service_rabbitmq.py:59
 #, python-brace-format
 msgid "正在为 {environment} 环境创建 RabbitMQ 服务实例..."
-msgstr ""
+msgstr "Creating RabbitMQ service instance for {environment} environment..."
 
 #: paasng/platform/mgrlegacy/legacy_proxy.py:79
 msgid "暂不支持轻应用迁移"
@@ -3902,6 +3920,11 @@ msgstr ""
 "Unable to get SVN branch information, please check the warehouse address and "
 "authentication information"
 
+#: paasng/platform/sourcectl/views.py:418
+#, python-format
+msgid "%s的仓库信息查询异常"
+msgstr "The warehouse information query of %s is abnormal"
+
 #: paasng/platform/sourcectl/views.py:488
 #, python-brace-format
 msgid "仓库信息查询异常: {e}"
@@ -4107,8 +4130,10 @@ msgid "访问受保护资源失败"
 msgstr "Failed to access protected resources"
 
 #: paasng/utils/error_codes.py:53
-msgid "无法彻底删除软删除的应用"
-msgstr ""
+#, fuzzy
+#| msgid "无法删除应用集群"
+msgid "无法彻底删除应用"
+msgstr "cannot delete cluster"
 
 #: paasng/utils/error_codes.py:55
 msgid "模块创建失败"
@@ -4550,6 +4575,16 @@ msgstr "\"{input}\" is not a valid format, please startswith \"base64,\""
 msgid "\"{input}\" is not a valid base64, please check it."
 msgstr "\"{input}\" is not a valid base64, please check it."
 
+#: paasng/utils/serializers.py:296
+#, python-brace-format
+msgid "至多包含 {max_items} 个对象."
+msgstr ""
+
+#: paasng/utils/serializers.py:297
+#, python-brace-format
+msgid "至少包含 {min_items} 个对象."
+msgstr ""
+
 #: paasng/utils/views.py:43
 msgid "参数格式错误"
 msgstr "Parameter format error"

apiserver/paasng/paas_wl/bk_app/cnative/specs/views.py

@@ -19,11 +19,13 @@
 from contextlib import suppress
 from urllib.parse import quote
 
+import requests
 from django.conf import settings
 from django.db import IntegrityError, transaction
 from django.shortcuts import get_object_or_404
 from django.utils.translation import gettext_lazy as _
 from drf_yasg.utils import swagger_auto_schema
+from moby_distribution.registry.exceptions import AuthFailed, PermissionDeny, ResourceNotFound
 from moby_distribution.registry.utils import parse_image
 from rest_framework import status
 from rest_framework.pagination import LimitOffsetPagination
@@ -116,7 +118,7 @@ def _validate_registry_permission(self, registry_service: DockerRegistryControll
             # bkrepo 的 docker 仓库，镜像凭证没有填写正确时，.touch() 时会抛出异常
             if registry_service.touch():
                 return
-            raise error_codes.INVALID_CREDENTIALS.f(_("权限不足或仓库不可达"))
+            raise error_codes.LIST_TAGS_FAILED.f(_("权限不足或仓库不可达"))
 
     @swagger_auto_schema(response_serializer=AlternativeVersionSLZ(many=True))
     def list_tags(self, request, code, module_name):
@@ -148,6 +150,14 @@ def list_tags(self, request, code, module_name):
 
         try:
             alternative_versions = AlternativeVersionSLZ(registry_service.list_alternative_versions(), many=True).data
+        except ResourceNotFound:
+            raise error_codes.LIST_TAGS_FAILED.f(_("镜像仓库不存在，请检查仓库地址是否正确"), replace=True)
+        except PermissionDeny:
+            raise error_codes.INVALID_CREDENTIALS.f(_("镜像仓库权限不足, 请检查是否配置镜像凭证"), replace=True)
+        except AuthFailed:
+            raise error_codes.INVALID_CREDENTIALS.f(_("镜像仓库凭证错误, 请检查镜像凭证配置是否正确"), replace=True)
+        except requests.exceptions.Timeout:
+            raise error_codes.LIST_TAGS_FAILED.f(_("镜像仓库请求超时, 请检查网络连接"), replace=True)
         except Exception:
             if endpoint == "mirrors.tencent.com":
                 # 镜像源迁移期间不能保证 registry 所有接口可用, 迁移期间增量镜像仓库无法查询 tag
@@ -163,7 +173,7 @@ def list_tags(self, request, code, module_name):
                     }
                 )
             logger.exception("unable to fetch repo info, may be the credential error or a network exception.")
-            raise error_codes.LIST_TAGS_FAILED.f(_("%s的仓库信息查询异常") % code)
+            raise error_codes.LIST_TAGS_FAILED.f(_("拉取镜像 Tag 失败"), replace=True)
         return Response(data=alternative_versions)