github.com/argoproj/argo-cd/v3@v3.2.1/docs/try_argo_cd_locally.md (about)

     1  # Try Argo CD Locally
     2  
     3  !!! tip
     4      This guide assumes you have a grounding in the tools that Argo CD is based on. Please read [understanding the basics](understand_the_basics.md) to learn about these tools.
     5  
     6  
     7  Follow these steps to install `Kind` for local development and set it up with Argo CD.
     8  
     9  To run an Argo CD development environment review the [developer guide for running locally](./developer-guide/running-locally.md).
    10  
    11  ## Install Kind
    12  
    13  Install Kind Following Instructions [here](https://kind.sigs.k8s.io/docs/user/quick-start#installation).
    14  
    15  ##  Create a Kind Cluster
    16  Once Kind is installed, create a new Kubernetes cluster with:
    17  ```bash
    18  kind create cluster --name argocd-cluster
    19  ```
    20  This will create a local Kubernetes cluster named `argocd-cluster`.
    21  
    22  ## Set Up kubectl to Use the Kind Cluster
    23  After creating the cluster, set `kubectl` to use your new `kind` cluster:
    24  ```bash
    25  kubectl cluster-info --context kind-argocd-cluster
    26  ```
    27  This command verifies that `kubectl` is pointed to the right cluster.
    28  
    29  ## Install ArgoCD on the Cluster
    30  You can now install Argo CD on your `kind` cluster. First, apply the Argo CD manifest to create the necessary resources:
    31  ```bash
    32  kubectl create namespace argocd
    33  kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
    34  ```
    35  
    36  ## Expose ArgoCD API Server
    37  By default, Argo CD's API server is not exposed outside the cluster. You need to expose it to access the UI locally. For development purposes, you can use Kubectl 'port-forward'.
    38  ```bash
    39  kubectl port-forward svc/argocd-server -n argocd 8080:443
    40  ```
    41  This will forward port 8080 on your local machine to the ArgoCD API server’s port 443 inside the Kubernetes cluster.
    42  
    43  ## Access ArgoCD UI
    44  Now, you can open your browser and navigate to http://localhost:8080 to access the ArgoCD UI.
    45  
    46  ### Log in to ArgoCD
    47  To log in to the ArgoCD UI, you'll need the default admin password. You can retrieve it from the Kubernetes cluster:
    48  ```bash
    49  kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath='{.data.password}' | base64 -d
    50  ```
    51  Use the admin username and the retrieved password to log in.
    52  
    53  You can now move on to step #2 in the [Getting Started Guide](getting_started.md).