Java V2 Add Amazon ECR Basic Scenario files.

.doc_gen/metadata/ecr_metadata.yaml

@@ -1,6 +1,136 @@
 # zexi 0.4.0
+ecr_Hello:
+  title: Hello &ECR;
+  title_abbrev: Hello &ECR;
+  synopsis: get started using &ECR;.
+  category: Hello
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ecr
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ecr.java2_hello.main
+  services:
+    ecr: {listImages}
+ecr_PushImageCmd:
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ecr
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ecr.java2.push.image.main
+  services:
+    ecr: {PushImageCmd}
+ecr_SetRepositoryPolicy:
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ecr
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ecr.java2.set.repo.policy.main
+  services:
+    ecr: {SetRepositoryPolicy}
+ecr_GetRepositoryPolicy:
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ecr
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ecr.java2.get.repo.policy.main
+  services:
+    ecr: {GetRepositoryPolicy}
+ecr_GetAuthorizationToken:
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ecr
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ecr.java2.get.token.main
+  services:
+    ecr: {GetAuthorizationToken}
+ecr_StartLifecyclePolicyPreview:
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ecr
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ecr.java2.verify.image.main
+  services:
+    ecr: {StartLifecyclePolicyPreview}
+ecr_DescribeImages:
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ecr
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ecr.java2.verify.image.main
+  services:
+    ecr: {DescribeImages}
+ecr_DeleteRepository:
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ecr
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ecr.java2.delete.repo.main
+  services:
+    ecr: {DeleteRepository}
+ecr_CreateRepository:
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ecr
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ecr.java2.create.repo.main
+  services:
+    ecr: {CreateRepository}
 ecr_DescribeRepositories:
   languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/ecr
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - ecr.java2.describe.policy.main
     Rust:
       versions:
         - sdk_version: 1
@@ -25,3 +155,32 @@ ecr_ListImages:
                 - ecr.rust.list-images
   services:
     ecr: {ListImages}
+ecr_Scenario_RepositoryManagement:
+  title: Learn core operations for &ECR; using an &AWS; SDK
+  title_abbrev: Learn &ECR; core operations
+  synopsis_list:
+    - Create an &ECR; repository.
+    - Set repository policies.
+    - Retrieve repository URIs.
+    - Get &ECR; authorization tokens.
+    - Set lifecycle policies for &ECR; repositories.
+    - Push a Docker image to an &ECR; repository.
+    - Verify the existence of an image in an &ECR; repository.
+    - List &ECR; repositories for your account and get details about them.
+    - Delete &ECR; repositories.
+  category: Scenarios
+  languages:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/kms
+          sdkguide:
+          excerpts:
+            - description: Run an interactive scenario demonstrating &ECR; features.
+              snippet_tags:
+                - ecr.java2_scenario.parent.main
+            - description: A wrapper class for &ECR; SDK methods.
+              snippet_tags:
+                - ecr.java2_scenario.main
+  services:
+    ecr: {CreateRepository, DescribeRepositories, DeleteRepository, DescribeImages, StartLifecyclePolicyPreview, GetAuthorizationToken, GetRepositoryPolicy, SetRepositoryPolicy}

getting_started_scenarios/ecr_scenario/README.md

@@ -0,0 +1,64 @@
+# Amazon Elastic Container Registry Service Basic Scenario
+
+## Overview
+
+ This Amazon Elastic Container Registry Service (Amazon ECR) basic scenario demonstrates how to interact with the Amazon ECR service using an AWS SDK.  The scenario covers various operations such as creating an Amazon ECR repository, pushing images to the repository, setting an ECR repository policy, and so on. 
+
+ Here are the top six service operations this scenario covers. 
+
+1. **Create an ECR repository**: The program creates an Amazon ECR repository. 
+
+2. **Set an ECR repository policy**: The program sets an ECR repository policy, which grants the specified IAM role the necessary permissions to access the repository.
+
+3. **Retrieve an ECR authorization token**: The program retrieves an ECR authorization token which is required for subsequent operations.
+
+4. **Get the ECR repository URI**: The program retrieves the URI of the ECR repository.
+
+5. **Push a Docker image to the ECR repository**: The program pushes a local Docker image to the ECR repository using a Docker client.
+
+6. **Verify the image in the ECR repository**: The program verifies that the Docker image was successfully pushed to the ECR repository.
+
+Note: These steps are not the complete program, but summarizes the 5-6 high-level steps. See the Eng Spec for a complete listing of ECR operations. 
+
+### Resources
+
+The basic scenario requires an IAM role that has Amazon ECR permissions. To create an IAM role, see [Creating IAM roles](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html). 
+
+For more information about using permissions with ECR (for example, how to create Amazon ECR Identity-based policies), see [How Amazon Elastic Container Registry works with IAM](https://docs.aws.amazon.com/AmazonECR/latest/userguide/security_iam_service-with-iam.html).
+
+This scenario requires a local Docker image created using Bash. To create a local Docker image named "echo-text" using Bash, perform these steps:
+
+1. **Install Docker**: First, you'll need to install Docker and Docker Desktop on your system. You can download the appropriate Docker version for your operating system from the official Docker website (https://www.docker.com/get-started).
+
+2. **Go to the resource folder**: Go to the resource sub folder and notice the two files: `Dockerfile` and `hello.sh`.
+
+3. **Build the Docker image**: In the resource folder that contains `Dockerfile` and `hello.sh`, run the following command to build the Docker image:
+
+   ```bash
+   docker build -t echo-text .
+   ```
+
+   This command builds a Docker image with the tag "echo-text" using the instructions in the Dockerfile.
+
+4. **Run the Docker container**: Once the image is built, you can run a container based on the "echo-text" image by executing the following command:
+
+   ```bash
+   docker run echo-text
+   ```
+
+
+## Implementations
+
+This scenario example will be implemented in the following languages:
+
+- Java
+- Python
+- Kotlin
+
+## Additional reading
+
+- [Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/what-is-ecr.html)
+
+---
+
+Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. SPDX-License-Identifier: Apache-2.0