jira: add input component for streaming issues, comments, and changelog

cmd/tools/docs_gen/schema_test.go

@@ -45,7 +45,10 @@ func TestComponentExamples(t *testing.T) {
 				require.NoError(t, err)
 				for _, l := range lints {
 					// TODO: Remove this once kafka is out of the benthos repo examples
-					if !strings.Contains(l.What, "component kafka is deprecated") {
+					// The jira processor is deprecated in favour of the jira input but
+					// retains examples for its still-supported enrichment use case.
+					if !strings.Contains(l.What, "component kafka is deprecated") &&
+						!strings.Contains(l.What, "component jira is deprecated") {
 						t.Error(l.Error())
 					}
 				}

config/examples/jira_input.yaml

@@ -0,0 +1,26 @@
+# Example pipeline: stream Jira issues into stdout.
+#
+# Set environment variables:
+#   JIRA_BASE_URL=https://your-domain.atlassian.net
+#   JIRA_EMAIL=you@example.com
+#   JIRA_API_TOKEN=<token from id.atlassian.com>
+
+input:
+  jira:
+    base_url: ${JIRA_BASE_URL:https://your-domain.atlassian.net}
+    auth:
+      email: ${JIRA_EMAIL:you@example.com}
+      api_token: ${JIRA_API_TOKEN:xxx}
+    resource: issues
+    jql: 'project = ENG'
+    poll_interval: 60s
+    cursor:
+      cache: jira_state
+
+cache_resources:
+  - label: jira_state
+    file:
+      directory: /var/lib/redpanda-connect/jira
+
+output:
+  stdout: {}