feat: support excluding some packages from the target of aqua update (

#2752)

* feat: support excluding some packages from the target of `aqua update`

* docs: update JSON Schema

aqua/imports/cosign.yaml

@@ -1,2 +1,4 @@
 packages:
   - name: sigstore/cosign@v1.13.2
+    update:
+      enabled: false

json-schema/aqua-yaml.json

@@ -71,6 +71,9 @@
         },
         "link": {
           "type": "string"
+        },
+        "update": {
+          "$ref": "#/$defs/Update"
         }
       },
       "additionalProperties": false,
@@ -130,6 +133,15 @@
         ]
       },
       "type": "array"
+    },
+    "Update": {
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false,
+      "type": "object"
     }
   }
 }

pkg/config/aqua/config.go

@@ -14,9 +14,30 @@ type Package struct {
 	Tags        []string `yaml:",omitempty" json:"tags,omitempty"`
 	Description string   `yaml:",omitempty" json:"description,omitempty"`
 	Link        string   `yaml:",omitempty" json:"link,omitempty"`
+	Update      *Update  `yaml:",omitempty" json:"update,omitempty"`
 	FilePath    string   `json:"-" yaml:"-"`
 }
 
+type Update struct {
+	// # If enabled is false, aqua up command ignores the package.
+	// If the package name is passed to aqua up command explicitly, enabled is ignored.
+	// By default, enabled is true.
+	Enabled *bool `yaml:",omitempty" json:"enabled,omitempty"`
+	// The condition of allowed version.
+	// expr https://github.com/expr-lang/expr is used.
+	// By default, all versions are allowed.
+	// The version must meet both allowed_version and types.
+	AllowedVersion string `yaml:"allowed_version,omitempty" json:"allowed_version,omitempty"`
+	// The list of allowed update types
+	// By default, all types are allowed.
+	// major, minor, patch, other
+	Types []string `yaml:",omitempty" json:"types,omitempty"`
+}
+
+func (u *Update) GetEnabled() bool {
+	return u == nil || u.Enabled == nil || *u.Enabled
+}
+
 func (p *Package) UnmarshalYAML(unmarshal func(interface{}) error) error {
 	type alias Package
 	a := alias(*p)

pkg/controller/update/package.go

@@ -51,6 +51,12 @@ func (c *Controller) updatePackagesInFile(ctx context.Context, logE *logrus.Entr
 		return nil
 	}
 	for _, pkg := range pkgs {
+		if len(param.Args) == 0 && !param.Insert {
+			if !pkg.Package.Update.GetEnabled() {
+				// If the update is disabled, the package is ignored
+				continue
+			}
+		}
 		logE := logE.WithFields(logrus.Fields{
 			"package_name":    pkg.Package.Name,
 			"package_version": pkg.Package.Version,