support jq path expressions in ignore_difference block (argoproj-labs#108)

* Add support for jq path expressions in ignore_differences block

* Proper tf formatting

* Remove single quotes

* Fixes for dev/ci environments

* Add jq path expressions version contraint, skip acceptance test if not supported

Author: jarrod-manwaring

.github/workflows/tests.yml

@@ -14,7 +14,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        argocd_version: ["v2.1.2", "v2.0.5", "v.1.8.7"]
+        argocd_version: ["v2.1.3", "v2.0.5", "v1.8.7"]
     steps:
       - uses: actions/checkout@v2
       - uses: actions/setup-go@v1
@@ -42,8 +42,8 @@ jobs:
       - name: Set up ArgoCD ${{ matrix.argocd_version }}
         env:
           ARGOCD_VERSION: ${{ matrix.argocd_version }}
+          ARGOCD_CI: true
         run: |
-          curl https://raw.githubusercontent.com/argoproj/argo-cd/${ARGOCD_VERSION}/manifests/install.yaml > manifests/install/install.yml
           sh scripts/testacc_prepare_env.sh
           until $(nc -z 127.0.0.1 8080); do sleep 2;done
           netstat -tulpn

.gitignore

@@ -1,5 +1,6 @@
 terraform-provider-argocd
-./manifests/install/install.yml
+/manifests/install/argocd.yml
+/bin
 .idea
 .vscode
 # Env variables settings

argocd/features.go

@@ -20,13 +20,15 @@ import (
 
 const (
 	featureApplicationLevelSyncOptions = iota
+	featureIgnoreDiffJQPathExpressions
 	featureRepositoryGet
 	featureTokenIDs
 )
 
 var (
 	featureVersionConstraintsMap = map[int]*semver.Version{
 		featureApplicationLevelSyncOptions: semver.MustParse("1.5.0"),
+		featureIgnoreDiffJQPathExpressions: semver.MustParse("2.1.0"),
 		featureRepositoryGet:               semver.MustParse("1.6.0"),
 		featureTokenIDs:                    semver.MustParse("1.5.3"),
 	}

argocd/resource_argocd_application.go

@@ -104,6 +104,36 @@ func resourceArgoCDApplicationCreate(ctx context.Context, d *schema.ResourceData
 		}
 	}
 
+	featureIgnoreDiffJQPathExpressionsSupported, err := server.isFeatureSupported(featureIgnoreDiffJQPathExpressions)
+	if err != nil {
+		return []diag.Diagnostic{
+			{
+				Severity: diag.Error,
+				Summary:  "feature not supported",
+				Detail:   err.Error(),
+			},
+		}
+	}
+	hasJQPathExpressions := false
+	if spec.IgnoreDifferences != nil {
+		for _, id := range spec.IgnoreDifferences {
+			if id.JQPathExpressions != nil {
+				hasJQPathExpressions = true
+			}
+		}
+	}
+	if !featureIgnoreDiffJQPathExpressionsSupported && hasJQPathExpressions {
+		return []diag.Diagnostic{
+			{
+				Severity: diag.Error,
+				Summary: fmt.Sprintf(
+					"jq path expressions are only supported from ArgoCD %s onwards",
+					featureVersionConstraintsMap[featureIgnoreDiffJQPathExpressions].String()),
+				Detail: err.Error(),
+			},
+		}
+	}
+
 	app, err = c.Create(ctx, &applicationClient.ApplicationCreateRequest{
 		Application: application.Application{
 
@@ -256,6 +286,36 @@ func resourceArgoCDApplicationUpdate(ctx context.Context, d *schema.ResourceData
 			}
 		}
 
+		featureIgnoreDiffJQPathExpressionsSupported, err := server.isFeatureSupported(featureIgnoreDiffJQPathExpressions)
+		if err != nil {
+			return []diag.Diagnostic{
+				{
+					Severity: diag.Error,
+					Summary:  "feature not supported",
+					Detail:   err.Error(),
+				},
+			}
+		}
+		hasJQPathExpressions := false
+		if spec.IgnoreDifferences != nil {
+			for _, id := range spec.IgnoreDifferences {
+				if id.JQPathExpressions != nil {
+					hasJQPathExpressions = true
+				}
+			}
+		}
+		if !featureIgnoreDiffJQPathExpressionsSupported && hasJQPathExpressions {
+			return []diag.Diagnostic{
+				{
+					Severity: diag.Error,
+					Summary: fmt.Sprintf(
+						"jq path expressions are only supported from ArgoCD %s onwards",
+						featureVersionConstraintsMap[featureIgnoreDiffJQPathExpressions].String()),
+					Detail: err.Error(),
+				},
+			}
+		}
+
 		app, err := c.Get(ctx, &applicationClient.ApplicationQuery{
 			Name: &appName,
 		})

argocd/resource_argocd_application_test.go

@@ -1,11 +1,13 @@
 package argocd
 
 import (
+	"context"
 	"fmt"
 	"testing"
 
 	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/acctest"
 	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/terraform"
 )
 
 func TestAccArgoCDApplication(t *testing.T) {
@@ -190,6 +192,27 @@ ingress:
 					),
 				),
 			},
+			{
+				SkipFunc: testAccSkipFeatureIgnoreDiffJQPathExpressions,
+				Config: testAccArgoCDApplicationIgnoreDiffJQPathExpressions(
+					acctest.RandomWithPrefix("test-acc")),
+				Check: resource.ComposeTestCheckFunc(
+					resource.TestCheckResourceAttrSet(
+						"argocd_application.ignore_differences_jqpe",
+						"metadata.0.uid",
+					),
+					resource.TestCheckResourceAttr(
+						"argocd_application.ignore_differences_jqpe",
+						"spec.0.ignore_difference.0.jq_path_expressions.0",
+						".spec.replicas",
+					),
+					resource.TestCheckResourceAttr(
+						"argocd_application.ignore_differences_jqpe",
+						"spec.0.ignore_difference.1.jq_path_expressions.1",
+						".spec.template.spec.metadata.labels.somelabel",
+					),
+				),
+			},
 		},
 	})
 }
@@ -482,9 +505,9 @@ resource "argocd_application" "ignore_differences" {
     }
     
     ignore_difference {
-      group         = "apps"
-      kind          = "Deployment"
-      json_pointers = ["/spec/replicas"]
+      group               = "apps"
+      kind                = "Deployment"
+      json_pointers       = ["/spec/replicas"]
     }
 
     ignore_difference {
@@ -500,3 +523,64 @@ resource "argocd_application" "ignore_differences" {
 }
 	`, name)
 }
+
+func testAccArgoCDApplicationIgnoreDiffJQPathExpressions(name string) string {
+	return fmt.Sprintf(`
+resource "argocd_application" "ignore_differences_jqpe" {
+  metadata {
+    name      = "%s"
+    namespace = "argocd"
+    labels = {
+      acceptance = "true"
+    }
+  }
+
+  spec {
+    source {
+      repo_url        = "https://charts.bitnami.com/bitnami"
+      chart           = "redis"
+      target_revision = "15.3.0"
+    }
+
+    destination {
+      server    = "https://kubernetes.default.svc"
+      namespace = "default"
+    }
+    
+    ignore_difference {
+      group               = "apps"
+      kind                = "Deployment"
+      jq_path_expressions = [".spec.replicas"]
+    }
+
+    ignore_difference {
+      group         = "apps"
+      kind          = "StatefulSet"
+      name          = "someStatefulSet"
+      jq_path_expressions = [
+        ".spec.replicas",
+        ".spec.template.spec.metadata.labels.somelabel",
+      ]
+    }
+  }
+}
+	`, name)
+}
+
+func testAccSkipFeatureIgnoreDiffJQPathExpressions() (bool, error) {
+	p, _ := testAccProviders["argocd"]()
+	_ = p.Configure(context.Background(), &terraform.ResourceConfig{})
+	server := p.Meta().(*ServerInterface)
+	err := server.initClients()
+	if err != nil {
+		return false, err
+	}
+	featureSupported, err := server.isFeatureSupported(featureIgnoreDiffJQPathExpressions)
+	if err != nil {
+		return false, err
+	}
+	if !featureSupported {
+		return true, nil
+	}
+	return false, nil
+}

argocd/schema_application.go

@@ -362,6 +362,14 @@ func applicationSpecSchema() *schema.Schema {
 									Type: schema.TypeString,
 								},
 							},
+							"jq_path_expressions": {
+								Type:     schema.TypeSet,
+								Set:      schema.HashString,
+								Optional: true,
+								Elem: &schema.Schema{
+									Type: schema.TypeString,
+								},
+							},
 						},
 					},
 				},

argocd/structure_application.go

@@ -354,6 +354,12 @@ func expandApplicationIgnoreDifferences(ids []interface{}) (
 				elem.JSONPointers = append(elem.JSONPointers, jp.(string))
 			}
 		}
+		if v, ok := id["jq_path_expressions"]; ok {
+			jqpes := v.(*schema.Set).List()
+			for _, jqpe := range jqpes {
+				elem.JQPathExpressions = append(elem.JQPathExpressions, jqpe.(string))
+			}
+		}
 		result = append(result, elem)
 	}
 	return
@@ -473,11 +479,12 @@ func flattenApplicationIgnoreDifferences(ids []application.ResourceIgnoreDiffere
 	result []map[string]interface{}) {
 	for _, id := range ids {
 		result = append(result, map[string]interface{}{
-			"group":         id.Group,
-			"kind":          id.Kind,
-			"name":          id.Name,
-			"namespace":     id.Namespace,
-			"json_pointers": id.JSONPointers,
+			"group":               id.Group,
+			"kind":                id.Kind,
+			"name":                id.Name,
+			"namespace":           id.Namespace,
+			"json_pointers":       id.JSONPointers,
+			"jq_path_expressions": id.JQPathExpressions,
 		})
 	}
 	return

docs/resources/application.md

@@ -69,6 +69,11 @@ resource "argocd_application" "kustomize" {
         "/spec/replicas",
         "/spec/template/spec/metadata/labels/bar",
       ]
+      # Only available from ArgoCD 2.1.0 onwards
+      jq_path_expressions = [
+        ".spec.replicas",
+        ".spec.template.spec.metadata.labels.bar",
+      ]
     }
   }
 }
@@ -174,6 +179,7 @@ Each `ignore_difference` block can have the following attributes:
 * `name` - (Optional) The targeted Kubernetes resource name.
 * `namespace` - (Optional) The targeted Kubernetes resource namespace.
 * `json_pointers` - (Optional) List of JSONPaths strings targeting the field(s) to ignore.
+* `jq_path_expressions` - (Optional) List of jq path expression strings targeting the field(s) to ignore (only available from ArgoCD 2.1.0 onwards).
 
 The `source` block has the following attributes:
 * `repo_url` - (Required) string, repository URL of the application manifests.

manifests/install/git-private-repository.yml

@@ -109,4 +109,4 @@ spec:
     - port: 22
       targetPort: sshd
       name: sshd
-      protocol: TCP
+      protocol: TCP

manifests/install/kustomization.yml

@@ -4,7 +4,7 @@ kind: Kustomization
 namespace: argocd
 resources:
   - namespace.yml
-  - https://raw.githubusercontent.com/argoproj/argo-cd/v1.8.3/manifests/install.yaml
+  - argocd.yml
   - git-private-repository.yml
   - proxy-service.yml
 patchesStrategicMerge: