// Module included in the following assemblies:
//
// microshift_running_apps/microshift-gitops.adoc

:_mod-docs-content-type: PROCEDURE
[id="microshift-gitops-adding-apps_{context}"]
= Creating GitOps applications on {microshift-short}

You can create a custom YAML configuration to deploy and manage applications in your {microshift-short} service. To install the necessary packages to run GitOps applications, follow the documentation in "Installing the GitOps Argo CD manifests from an RPM package".

.Prerequisites

* You installed the `microshift-gitops` packages.

* The Argo CD pods are running in the `openshift-gitops` namespace.

.Procedure

. Create a YAML file and add your customized configurations for the application:
+
.Example YAML for a `spring-petclinic` application
[source,yaml]
----
kind: AppProject
apiVersion: argoproj.io/v1alpha1
metadata:
  name: default
  namespace: openshift-gitops
spec:
  clusterResourceWhitelist:
  - group: '*'
    kind: '*'
  destinations:
  - namespace: '*'
    server: '*'
  sourceRepos:
  - '*'
---
kind: Application
apiVersion: argoproj.io/v1alpha1
metadata:
  name: spring-petclinic
  namespace: openshift-gitops
spec:
  destination:
    namespace: spring-petclinic
    server: https://kubernetes.default.svc
  project: default
  source:
    directory:
      recurse: true
    path: app
    repoURL: https://github.com/siamaksade/openshift-gitops-getting-started
  syncPolicy:
    automated: {}
    syncOptions:
    - CreateNamespace=true
    - ServerSideApply=true
----

. To deploy the applications defined in the YAML file, run the following command:
+
[source,terminal]
----
$ oc apply -f <my-app>.yaml <1>
----
<1> Replace _<my-app>_ with the name of your application YAML.

.Verification

* To verify your application is deployed and synced, run the following command:
+
[source,terminal]
----
$ oc get applications -A
----
It might take a few minutes for the application to show the `Healthy` status.
+
.Example output
[source,terminal]
----
NAMESPACE          NAME               SYNC STATUS   HEALTH STATUS
openshift-gitops   spring-petclinic   Synced        Healthy
----