optional tools and quay account

Author: dmarrazzo

documentation/modules/ROOT/pages/pushing.adoc

@@ -2,29 +2,34 @@
 
 So far you've been working with your container image locally. Now let's take it to a remote registry.
 
-== Tagging an image
+[IMPORTANT]
+====
+Before continuing you will need to have/create a container registry account. You can sign up for a free one at https://quay.io[Quay.io] or the https://hub.docker.com/[Docker Hub]. 
 
-IMPORTANT: Before continuing you will need to have/create a container registry account. You can sign up for a free one at https://quay.io[Quay.io] or the https://hub.docker.com/[Docker Hub]. 
+Instructions on how to create your Quay.io account are available in the xref:setup.adoc[Setup] section.
+====
+
+== Tagging an image
 
-First you'll need to tag your image accordingly to the registry and name you gave to your repository. Say for example we create a repository `myrepository`.
+First you'll need to tag your image accordingly to the registry and name you gave to your repository. Say for example we create a repository `my-image` in the organization id `your-user`.
 
 If you have a Docker Hub account:
 
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
 ----
-podman tag my-image docker.io/myrepository/my-image
+podman tag my-image docker.io/your-user/my-image
 ----
 
 If using Quay.io:
 
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
 ----
-podman tag my-image quay.io/myrepository/my-image
+podman tag my-image quay.io/your-user/my-image
 ----
 
-IMPORTANT: Make sure to replace `myrepository` with the name of your own repository.
+IMPORTANT: Make sure to replace `your-user` with the name of your own user id or organization id.
 
 [TIP]
 ====
@@ -33,7 +38,7 @@ If you build your image already using the tag, you won't need to do this step be
 [.console-input]
 [source,bash,subs="+macros,+attributes"]
 ----
-podman build -t quay.io/myrepository/my-image .
+podman build -t quay.io/your-user/my-image .
 ----
 
 ====
@@ -45,7 +50,7 @@ If you now run `podman images` you'll see something like this:
 ----
 REPOSITORY                                   TAG                 IMAGE ID            CREATED             SIZE
 my-image                                     latest              a63dec174904        55 minutes ago      516MB
-quay.io/myrepository/my-image                latest              a63dec174904        55 minutes ago      516MB
+quay.io/your-user/my-image                latest              a63dec174904        55 minutes ago      516MB
 ----
 
 == Pushing an image
@@ -79,15 +84,15 @@ And finally you can push it, eg.:
 [.console-input]  
 [source,bash,subs="+macros,+attributes"]
 ----
-podman push quay.io/myrepository/my-image
+podman push quay.io/your-user/my-image
 ----
 
 You should have an output like this:
 
 [.console-output]
 [source,text]
 ----
-The push refers to repository [quay.io/myrepository/my-image]
+The push refers to repository [quay.io/your-user/my-image]
 abea900bc08c: Pushed
 99d5cac89a03: Pushed
 7b08010864ba: Pushed

documentation/modules/ROOT/pages/setup.adoc

@@ -10,8 +10,7 @@ TIP: By default, the commands in this tutorial are using podman, but you can use
 
 [options="header"]
 |===
-|**Tool**|**macOS**|**Fedora**|**Windows**
-
+| **Tool** | **macOS** | **Fedora** |**Windows**
 
 | **Podman Desktop**
 | https://podman-desktop.io/downloads[Podman Desktop for Mac, window="_blank"]
@@ -30,7 +29,55 @@ TIP: By default, the commands in this tutorial are using podman, but you can use
 | `dnf install maven`
 | https://maven.apache.org/download.cgi[Windows] (Make sure you set the `MAVEN_HOME` environment variable and add `%MAVEN_HOME%\bin` to your `PATH`)
 
+|===
+
+== Optional Tools
+
+The following tools are optional, feel free to replace with your own preferred ones.
+
 
+[options="header"]
 |===
+|**Tool**|**macOS**|**Fedora**|**Windows**
+
+| **Visual Studio Code**
+3+| Open https://code.visualstudio.com/download[Visual Studio Code download page, window="_blank"] and follow the installation instructions related to your operating system
+
+| **curl**
+| `brew install curl`
+| `dnf install curl`
+| https://curl.se/windows/[Windows]
+
+|===
+
+== Quay.io Account
+
+**Quay.io** is a **container image registry** service, similar to _Docker Hub_, which is fully managed by Red Hat. It provides a centralized, secure place for users and organizations to store, build, and distribute their OCI (Open Container Initiative) container images.
+
+NOTE: If you already have a _Quay.io_ account or a _Docker Hub_ account, you can skip this section.
+
+=== Creating a Quay.io Account
+
+A Quay.io account is typically linked to a **Red Hat account**.
+
+1.  **Navigate to Quay.io**: Go to the Quay.io website.
+2.  **Sign In/Register**: Look for a **Sign In** or **Register** option. Since Quay.io is part of Red Hat's ecosystem, you'll be directed to use your Red Hat credentials.
+      * If you **already have a Red Hat account**, sign in with those credentials.
+      * If you **do not have a Red Hat account**, you'll be prompted to create one first. Follow the prompts to register for a new Red Hat account.
+3.  **Confirm Username**: Upon your first login to Quay.io using your Red Hat credentials, you may be redirected to a page to **confirm your username**. This username will serve as your **namespace** (e.g., `quay.io/<your-username>/<repo-name>`) in the container registry.
+
+
+=== Creating a Repository
+
+A repository is a storage location for your container images and related artifacts: think of it as a folder or directory for a specific containerized application or component.
 
---
+1.  **Log In**: Sign in to your Quay.io account.
+2.  **Navigate to Repositories**: On your main page, or in the navigation menu, look for a **Repositories** section or a **+** icon (or a **Create Repository** button).
+3.  **Select Repository Type**: Choose **Container Image Repository** (or similar option, if prompted).
+4.  **Enter Details**:
+      * **Namespace**: Select your username (or an Organization you belong to).
+      * **Repository Name**: Enter a name for your repository (e.g., `my-first-app`). **Avoid** using names like `build`, `trigger`, `tag`, or `notification` as they can cause access and deletion issues.
+5.  **Visibility**: Choose the **Repository Visibility**:
+      * **Public**: Anyone can pull this image (free tier typically allows unlimited public repositories).
+      * **Private**: Only you and users/teams you explicitly grant access to can pull this image (usually limited/paid in the free tier).
+6.  **Create**: Click the **Create Repository** button. The repository will now appear in your list, ready to receive images.