feat: add /var/lib persistent state directories for collector RPM/DEB packages

Add packaged /var/lib/<package> directories to otelcol, otelcol-contrib,
and otelcol-otlp distributions. These directories are needed for the
file_storage resiliency extension which persists the collector queue to
disk. See https://opentelemetry.io/docs/collector/resiliency/

- Add withVarLibDir(user, group) helper in builder.go
- Set mode 0750 (rwxr-x---) owned by the service user/group
- Regenerate .goreleaser.yaml files for affected distributions

Author: Copilot

.chloggen/add-var-lib-directories.yaml

@@ -0,0 +1,11 @@
+change_type: enhancement
+
+component: packaging
+
+note: Add /var/lib persistent state directories for collector RPM/DEB packages
+
+issues: [1396]
+
+subtext:
+
+change_logs: [user]

cmd/goreleaser/internal/builder.go

@@ -225,6 +225,27 @@ func (b *distributionBuilder) newNfpms(dist string) []config.NFPM {
 	}
 }
 
+func (b *distributionBuilder) withVarLibDir(user, group string) *distributionBuilder {
+	b.configFuncs = append(b.configFuncs, func(d *distribution) {
+		for i := range d.Nfpms {
+			d.Nfpms[i].Contents = append(d.Nfpms[i].Contents, config.NFPMContent{
+				Destination: path.Join("/var", "lib", d.Name),
+				Type:        "dir",
+				FileInfo: config.FileInfo{
+					Owner: user,
+					Group: group,
+					// 0750 (octal) = 488 (decimal). The generated YAML emits 488 because
+					// go.yaml.in/yaml/v3 serializes integers as decimal. This is intentional:
+					// decimal 488 is unambiguous across YAML 1.1 and 1.2, whereas octal
+					// notations (0750 / 0o750) are misinterpreted by one or the other.
+					Mode: 0750,
+				},
+			})
+		}
+	})
+	return b
+}
+
 func (b *distributionBuilder) withDefaultMSIConfig() *distributionBuilder {
 	b.configFuncs = append(b.configFuncs, func(d *distribution) {
 		d.MsiConfig = b.newMSIConfig(d.Name)

cmd/goreleaser/internal/distro_contrib.go

@@ -43,7 +43,7 @@ var (
 		d.ContainerImageManifests = slices.Concat(
 			newContainerImageManifests(d.Name, "linux", baseArchs, containerImageOptions{}),
 		)
-	}).withPackagingDefaults().withDefaultConfigIncluded().build()
+	}).withPackagingDefaults().withDefaultConfigIncluded().withVarLibDir("otelcol-contrib", "otelcol-contrib").build()
 
 	// contrib build-only project
 	contribBuildOnlyDist = newDistributionBuilder(contribDistro).withConfigFunc(func(d *distribution) {

cmd/goreleaser/internal/distro_otelcol.go

@@ -21,5 +21,5 @@ var (
 		d.ContainerImageManifests = slices.Concat(
 			newContainerImageManifests(d.Name, "linux", baseArchs, containerImageOptions{}),
 		)
-	}).withPackagingDefaults().withDefaultConfigIncluded().build()
+	}).withPackagingDefaults().withDefaultConfigIncluded().withVarLibDir("otel", "otel").build()
 )

cmd/goreleaser/internal/distro_otlp.go

@@ -21,5 +21,5 @@ var (
 		d.ContainerImageManifests = slices.Concat(
 			newContainerImageManifests(d.Name, "linux", baseArchs, containerImageOptions{}),
 		)
-	}).withPackagingDefaults().build()
+	}).withPackagingDefaults().withVarLibDir("otelcol-otlp", "otelcol-otlp").build()
 )

distributions/otelcol-contrib/.goreleaser.yaml

@@ -87,6 +87,12 @@ nfpms:
       - src: config.yaml
         dst: /etc/otelcol-contrib/config.yaml
         type: config|noreplace
+      - dst: /var/lib/otelcol-contrib
+        type: dir
+        file_info:
+          owner: otelcol-contrib
+          group: otelcol-contrib
+          mode: 488
     scripts:
       preinstall: preinstall.sh
       postinstall: postinstall.sh

distributions/otelcol-otlp/.goreleaser.yaml

@@ -78,6 +78,12 @@ nfpms:
       - src: otelcol-otlp.conf
         dst: /etc/otelcol-otlp/otelcol-otlp.conf
         type: config|noreplace
+      - dst: /var/lib/otelcol-otlp
+        type: dir
+        file_info:
+          owner: otelcol-otlp
+          group: otelcol-otlp
+          mode: 488
     scripts:
       preinstall: preinstall.sh
       postinstall: postinstall.sh

distributions/otelcol/.goreleaser.yaml

@@ -82,6 +82,12 @@ nfpms:
       - src: config.yaml
         dst: /etc/otelcol/config.yaml
         type: config|noreplace
+      - dst: /var/lib/otelcol
+        type: dir
+        file_info:
+          owner: otel
+          group: otel
+          mode: 488
     scripts:
       preinstall: preinstall.sh
       postinstall: postinstall.sh