events: document and test artifact events

- docs/source/markdown/podman-events.1.md: Documented the `artifact` event
  type, its associated statuses (`create`, `pull`, `push`, `remove`), the
  `artifact=` filter, and updated the Journald Identifiers table.
- test/e2e/events_test.go: Added an end-to-end test to verify that
  `podman artifact` operations properly emit the expected events in
  chronological order.

Signed-off-by: Byounguk Lee <nimdrak@gmail.com>

Author: nimdrak

docs/source/markdown/podman-events.1.md

@@ -70,6 +70,12 @@ The *image* event type reports the following statuses:
  * unmount
  * untag
 
+The *artifact* event type reports the following statuses:
+ * create
+ * pull
+ * push
+ * remove
+
 The *system* type reports the following statuses:
  * refresh
  * renumber
@@ -102,6 +108,7 @@ filters are supported:
 
 | **Filter** | **Description**                     |
 |------------|-------------------------------------|
+| artifact   | [Name or ID] Artifact name or ID    |
 | container  | [Name or ID] Container's name or ID |
 | event      | event_status (described above)      |
 | image      | [Name or ID] Image name or ID       |
@@ -167,8 +174,8 @@ The journald events-backend of Podman uses the following journald identifiers.
 | PODMAN_EVENT                  | The event status as described above                     |
 | PODMAN_TYPE                   | The event type as described above                       |
 | PODMAN_TIME                   | The time stamp when the event was written               |
-| PODMAN_NAME                   | Name of the event object (e.g., container, image)       |
-| PODMAN_ID                     | ID of the event object (e.g., container, image)         |
+| PODMAN_NAME                   | Name of the event object (e.g., container, image, artifact) |
+| PODMAN_ID                     | ID of the event object (e.g., container, image, artifact)   |
 | PODMAN_EXIT_CODE              | Exit code of the container                              |
 | PODMAN_POD_ID                 | Pod ID of the container                                 |
 | PODMAN_LABELS                 | Labels of the container                                 |

test/e2e/events_test.go

@@ -307,4 +307,47 @@ var _ = Describe("Podman events", func() {
 		Expect(result).Should(ExitCleanly())
 		Expect(result.OutputToStringArray()).ToNot(BeEmpty(), "Number of health_status events")
 	})
+
+	It("podman events for artifacts", func() {
+		artifactFile, err := createArtifactFile(1024)
+		Expect(err).ToNot(HaveOccurred())
+
+		lock, port, err := setupRegistry(nil)
+		if err == nil {
+			defer lock.Unlock()
+		}
+		Expect(err).ToNot(HaveOccurred())
+
+		artifactName := fmt.Sprintf("localhost:%s/test/events-artifact-remote:latest", port)
+		add := podmanTest.Podman([]string{"artifact", "add", artifactName, artifactFile})
+		add.WaitWithDefaultTimeout()
+		Expect(add).Should(ExitCleanly())
+
+		push := podmanTest.Podman([]string{"artifact", "push", "-q", "--tls-verify=false", artifactName})
+		push.WaitWithDefaultTimeout()
+		Expect(push).Should(ExitCleanly())
+
+		rm := podmanTest.Podman([]string{"artifact", "rm", artifactName})
+		rm.WaitWithDefaultTimeout()
+		Expect(rm).Should(ExitCleanly())
+
+		pull := podmanTest.Podman([]string{"artifact", "pull", "-q", "--tls-verify=false", artifactName})
+		pull.WaitWithDefaultTimeout()
+		Expect(pull).Should(ExitCleanly())
+
+		var events []string
+		Eventually(func() int {
+			result := podmanTest.Podman([]string{"events", "--stream=false", "--filter", "type=artifact", "--filter", "artifact=" + artifactName})
+			result.WaitWithDefaultTimeout()
+			Expect(result).Should(ExitCleanly())
+			events = result.OutputToStringArray()
+			return len(events)
+		}, defaultWaitTimeout, 2).Should(BeNumerically("==", 4), "number of artifact events")
+
+		Expect(events).To(HaveLen(4), "number of artifact events")
+		Expect(events[0]).To(And(ContainSubstring("artifact create"), ContainSubstring(artifactName)), "event log includes artifact create")
+		Expect(events[1]).To(And(ContainSubstring("artifact push"), ContainSubstring(artifactName)), "event log includes artifact push")
+		Expect(events[2]).To(And(ContainSubstring("artifact remove"), ContainSubstring(artifactName)), "event log includes artifact remove")
+		Expect(events[3]).To(And(ContainSubstring("artifact pull"), ContainSubstring(artifactName)), "event log includes artifact pull")
+	})
 })