feat(build): add global staged directive

Signed-off-by: QinZhanlong <qinzhanlong071@163.com>

docs/_data/werf_yaml.yml

@@ -28,6 +28,11 @@ sections:
               en: Common list of target platforms for all images (for example ['linux/amd64', 'linux/arm64', 'linux/arm/v8'])
               ru: Общий список целевых платформ для всех образов (например ['linux/amd64', 'linux/arm64', 'linux/arm/v8'])
             value: "[ string, ... ]"
+          - name: staged
+            value: "bool"
+            description:
+              en: "Enable layer-by-layer caching of Dockerfile instructions in container registry globally for all images"
+              ru: "Включить послойное кеширование инструкций Dockerfile в container registry глобально для всех образов"
       - name: deploy
         description:
           en: Settings for deployment

docs/pages_en/usage/build/process.md

@@ -125,7 +125,7 @@ If you run a build with storing images in the repository, werf will first check
 
 By default, Dockerfile images are cached by a single image in the container registry.
 
-To enable layered caching of Dockerfile instructions in the container registry, use the `staged` directive in werf.yaml:
+To enable layered caching of Dockerfile instructions in the container registry, use the `staged` directive in werf.yaml. The directive can be set globally at the root level of werf.yaml for all images, or locally for specific images where the local setting will override the global one:
 
 ```yaml
 # werf.yaml

docs/pages_ru/usage/build/process.md

@@ -123,7 +123,7 @@ werf build --repo REPO --add-custom-tag "%image%-latest"
 
 По умолчанию Dockerfile-образы кешируются одним образом в container registry. 
 
-Для включения послойного кеширования Dockerfile-инструкций в container registry необходимо использовать директиву `staged` в werf.yaml:
+Для включения послойного кеширования Dockerfile-инструкций в container registry необходимо использовать директиву `staged` в werf.yaml. Директива может быть установлена глобально на корневом уровне werf.yaml для всех образов или локально для конкретных образов, где локальная настройка переопределит глобальную:
 
 ```yaml
 # werf.yaml

pkg/config/meta_build.go

@@ -2,4 +2,5 @@ package config
 
 type MetaBuild struct {
 	Platform []string
+	Staged   bool
 }

pkg/config/parser.go

@@ -502,6 +502,9 @@ func prepareWerfConfig(giterminismManager giterminism_manager.Interface, rawImag
 		}
 
 		for _, image := range imageList {
+			if !rawImage.isFillStaged {
+				image.Staged = meta.Build.Staged
+			}
 			images = append(images, image)
 		}
 	}
@@ -571,6 +574,9 @@ func splitByMetaAndRawImages(docs []*doc) (*Meta, []*rawStapelImage, []*rawImage
 			resultMeta = rawMeta.toMeta()
 		case isImageFromDockerfileDoc(raw):
 			imageFromDockerfile := &rawImageFromDockerfile{doc: doc}
+			if isStagedDoc(raw) {
+				imageFromDockerfile.isFillStaged = true
+			}
 			err := yaml.UnmarshalStrict(doc.Content, &imageFromDockerfile)
 			if err != nil {
 				return nil, nil, nil, newYamlUnmarshalError(err, doc)
@@ -617,6 +623,14 @@ func isImageFromDockerfileDoc(h map[string]interface{}) bool {
 	return false
 }
 
+func isStagedDoc(h map[string]interface{}) bool {
+	if _, ok := h["staged"]; ok {
+		return true
+	}
+
+	return false
+}
+
 func newYamlUnmarshalError(err error, doc *doc) error {
 	switch err.(type) {
 	case *configError:

pkg/config/raw_image_from_dockerfile.go

@@ -24,7 +24,8 @@ type rawImageFromDockerfile struct {
 	Platform        []string               `yaml:"platform,omitempty"`
 	RawSecrets      []*rawSecret           `yaml:"secrets,omitempty"`
 
-	doc *doc `yaml:"-"` // parent
+	doc          *doc `yaml:"-"` // parent
+	isFillStaged bool `yaml:"-"` // indicates whether 'staged' field is explicitly set in the image section
 
 	UnsupportedAttributes map[string]interface{} `yaml:",inline"`
 }

pkg/config/raw_meta_build.go

@@ -2,8 +2,8 @@ package config
 
 type rawMetaBuild struct {
 	Platform []string `yaml:"platform,omitempty"`
-
-	rawMeta *rawMeta
+	Staged   bool     `yaml:"staged,omitempty"`
+	rawMeta  *rawMeta
 
 	UnsupportedAttributes map[string]interface{} `yaml:",inline"`
 }
@@ -31,5 +31,6 @@ func (c *rawMetaBuild) UnmarshalYAML(unmarshal func(interface{}) error) error {
 func (c *rawMetaBuild) toMetaBuild() MetaBuild {
 	metaBuild := MetaBuild{}
 	metaBuild.Platform = c.Platform
+	metaBuild.Staged = c.Staged
 	return metaBuild
 }