仓库自包含化：Docker/CI/文档/规范入库，路由分组拆分

2026-07-09 19:18:04 +08:00
parent b9a3e97e84
commit 3e0389c1e9
83 changed files with 20241 additions and 248 deletions
@@ -8,6 +8,12 @@ import (
 	"oci-portal/internal/oci"
 )

+// @Summary  可用域列表
+// @Tags     租户配置
+// @Param    id path int true "配置 ID"
+// @Success  200 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/availability-domains [get]
 func (h *ociConfigHandler) availabilityDomains(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -58,6 +64,12 @@ type instanceActionRequest struct {
 	Action string `json:"action" binding:"required"`
 }

+// @Summary  实例列表
+// @Tags     计算
+// @Param    id path int true "配置 ID"
+// @Success  200 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/instances [get]
 func (h *ociConfigHandler) listInstances(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -71,6 +83,13 @@ func (h *ociConfigHandler) listInstances(c *gin.Context) {
 	c.JSON(http.StatusOK, instances)
 }

+// @Summary  创建实例
+// @Tags     计算
+// @Param    id path int true "配置 ID"
+// @Param    body body createInstanceRequest true "请求体"
+// @Success  201 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/instances [post]
 func (h *ociConfigHandler) createInstance(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -124,6 +143,13 @@ func (h *ociConfigHandler) createInstance(c *gin.Context) {
 	c.JSON(status, gin.H{"instances": instances, "errors": failures})
 }

+// @Summary  实例详情
+// @Tags     计算
+// @Param    id path int true "配置 ID"
+// @Param    instanceId path string true "instanceId"
+// @Success  200 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/instances/{instanceId} [get]
 func (h *ociConfigHandler) getInstance(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -137,6 +163,14 @@ func (h *ociConfigHandler) getInstance(c *gin.Context) {
 	c.JSON(http.StatusOK, instance)
 }

+// @Summary  更新实例
+// @Tags     计算
+// @Param    id path int true "配置 ID"
+// @Param    instanceId path string true "instanceId"
+// @Param    body body updateInstanceRequest true "请求体"
+// @Success  200 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/instances/{instanceId} [put]
 func (h *ociConfigHandler) updateInstance(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -161,6 +195,13 @@ func (h *ociConfigHandler) updateInstance(c *gin.Context) {
 	c.JSON(http.StatusOK, instance)
 }

+// @Summary  终止实例
+// @Tags     计算
+// @Param    id path int true "配置 ID"
+// @Param    instanceId path string true "instanceId"
+// @Success  204 "无内容"
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/instances/{instanceId} [delete]
 func (h *ociConfigHandler) terminateInstance(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -174,6 +215,14 @@ func (h *ociConfigHandler) terminateInstance(c *gin.Context) {
 	c.Status(http.StatusNoContent)
 }

+// @Summary  实例电源操作(启停/重启)
+// @Tags     计算
+// @Param    id path int true "配置 ID"
+// @Param    instanceId path string true "instanceId"
+// @Param    body body instanceActionRequest true "请求体"
+// @Success  200 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/instances/{instanceId}/action [post]
 func (h *ociConfigHandler) instanceAction(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -201,6 +250,12 @@ type updateBootVolumeRequest struct {
 	VpusPerGB   int64  `json:"vpusPerGB"`
 }

+// @Summary  引导卷列表
+// @Tags     存储
+// @Param    id path int true "配置 ID"
+// @Success  200 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/boot-volumes [get]
 func (h *ociConfigHandler) listBootVolumes(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -214,6 +269,13 @@ func (h *ociConfigHandler) listBootVolumes(c *gin.Context) {
 	c.JSON(http.StatusOK, volumes)
 }

+// @Summary  引导卷详情
+// @Tags     存储
+// @Param    id path int true "配置 ID"
+// @Param    bootVolumeId path string true "bootVolumeId"
+// @Success  200 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/boot-volumes/{bootVolumeId} [get]
 func (h *ociConfigHandler) getBootVolume(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -227,6 +289,14 @@ func (h *ociConfigHandler) getBootVolume(c *gin.Context) {
 	c.JSON(http.StatusOK, volume)
 }

+// @Summary  更新引导卷
+// @Tags     存储
+// @Param    id path int true "配置 ID"
+// @Param    bootVolumeId path string true "bootVolumeId"
+// @Param    body body updateBootVolumeRequest true "请求体"
+// @Success  200 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/boot-volumes/{bootVolumeId} [put]
 func (h *ociConfigHandler) updateBootVolume(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -250,6 +320,13 @@ func (h *ociConfigHandler) updateBootVolume(c *gin.Context) {
 	c.JSON(http.StatusOK, volume)
 }

+// @Summary  删除引导卷
+// @Tags     存储
+// @Param    id path int true "配置 ID"
+// @Param    bootVolumeId path string true "bootVolumeId"
+// @Success  204 "无内容"
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/boot-volumes/{bootVolumeId} [delete]
 func (h *ociConfigHandler) deleteBootVolume(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {