Skip to content

Commit

Permalink
Update getting started section
Browse files Browse the repository at this point in the history
  • Loading branch information
gnunn1 committed Oct 28, 2024
1 parent d3f5193 commit ff047a8
Show file tree
Hide file tree
Showing 31 changed files with 66 additions and 7,561 deletions.
Binary file not shown.
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/argocd-app2.png
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/argocd-app3.png
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed content/modules/ROOT/assets/images/bgd-green.png
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/bgd-helm1.png
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/bgd-helm2.png
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/bgd-helm3.png
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/bgd-helm4.png
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/bgd-helm5.png
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/bgd-purple.png
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/bgd.png
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/bgdapp.png
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/fullysynced.png
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/out-of-sync.png
Binary file not shown.
2,078 changes: 0 additions & 2,078 deletions content/modules/ROOT/assets/images/presyncpost.excalidraw

This file was deleted.

Binary file removed content/modules/ROOT/assets/images/presyncpost.png
Binary file not shown.
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/todo-app.png
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/todo-argocd.png
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/todo-card.png
Binary file not shown.
5,481 changes: 0 additions & 5,481 deletions content/modules/ROOT/assets/images/todo-schema.excalidraw

This file was deleted.

Binary file removed content/modules/ROOT/assets/images/two-apps.png
Binary file not shown.
Binary file removed content/modules/ROOT/assets/images/yellowoutput.png
Diff not rendered.
3 changes: 2 additions & 1 deletion content/modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
* xref:01-getting-started.adoc[1. Getting Started]
** xref:01-getting-started.adoc#cluster-login[Cluster Login]
** xref:01-getting-started.adoc#open-web-terminal[Open the Web Terminal]
** xref:01-getting-started.adoc#argocd-login[Argo CD Login]
** xref:01-getting-started.adoc#gitops-architecture[OpenShift GitOps Architecture]
* xref:02-argocd-rbac.adoc[2. Argo CD RBAC]
Expand Down
63 changes: 63 additions & 0 deletions content/modules/ROOT/pages/01-getting-started.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -84,3 +84,66 @@ In order to copy and paste content into the terminal, you can use
the secondary (typically right click) menus to do so. You can also
use the keyboard to paste content with the shortcut <ctrl><shift><v>.
====

[#argocd-login]
= OpenShift GitOps Login

While Argo CD generates a default `admin` user and a random password when first
deployed you can also configure Argo CD to use the OpenShift authentication.
You can connect to Argo CD using this user account via the CLI or web
console. In this workshop, we will only use the Argo CD web console.

Click on the following link to access the Argo CD user interface:

link:https://argocd-server-{user}-argocd.{domain}[{https://argocd-server-{user}-argocd.{domain}},window='_blank']

Click on the `Log In Via OpenShift` button and use the same username
and password that you used to login in with OpenShift.

image::argo-cd-login.png[ArgoCDLogin, 600]

After you enter your credentials you will see the following prompting you to authorize access,
click the "Allow selected permissions" button.

image::argo-cd-allow-access.png[ArgoCDAuthorize, 600]

Once you've logged in, you should see the following page. This is the Argo CD
Web UI.

image::argocd-login2.png[ArgoCDLogin2, 600]

[#gitops-architecture]
= OpenShift GitOps Architecture

In this section we will do a brief overview of the OpenShift GitOps architecture which is depicted in the diagram below.

image::gitops/argocd-architecture.png[]

[NOTE]
In the diagram above, everything contained within the dotted is running in OpenShift whereas outside the line are external
dependencies or interactions.

The OpenShift GitOps operator is used to deploy, manage and upgrade an installation of Argo CD which runs in a
specified namespace. The Argo CD installation contains several components, running as individual deployments,
which are as follows:

1. *Application Controller*. This component is responsible for deploying Kubernetes resources and watching the resources for change,
to do so it interacts with the Kubernetes API.
2. *Repo Server*. This component manages access to the manifests via a git repository, it is responsible for
fetching the manifests (i.e. yaml files). These manifests can be built from raw yaml, helm or kustomize but
additional tools can be used via a plugin architecture. For improved performance, it caches these manifests
in the redis component.
3. *Server*. This provides the user interface as well as a REST API.
4. *Dex (optional)*. Provides authentication via OpenShift OAuth2, in this workshop it is not used as we
are authenticating directly against Keycloak.
5. *ApplicationSet Controller (Not shown)*. This component is responsible for managing ApplicationSets which
are used to generate Applications using generators. These generators can create Applications based on Pull Requests,
directories in git, clusters, etc.

Check that these have been deployed successfully in your Argo CD namespace:

[.console-input]
[source,bash,subs="attributes+,+macros"]
----
oc get all -n {user}-argocd
----
2 changes: 1 addition & 1 deletion content/modules/ROOT/pages/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
:page-layout: home
:!sectids:

OpenShift Gitops is based on the upstream
OpenShift GitOps is based on the upstream
https://argoproj.github.io/argo-cd/[Argo CD,window='_blank'] project. ArgoCD is
a declarative, GitOps continuous delivery tool for Kubernetes.

Expand Down

0 comments on commit ff047a8

Please sign in to comment.