Provision a Hosted GitOps Runtime

Install the GitOps Runtime hosted by Codefresh

If you have Hosted GitOps, set up your hosted Runtime environment:

  1. Provision the Hosted GitOps Runtime with a single click.
  2. Authorize access through your OAuth token to the organization where Codefresh creates the Git runtime repo and the Shared Configuration Repo.
  3. Connect to an external K8s cluster with access to the internet, to which you can deploy applications. This is important as you cannot deploy to the in-cluster with the Hosted GitOps Runtime.
  4. Install Argo Rollouts on the cluster.

Read our blog on Hosted GitOps.
For detailed information on each of the steps below, see Set up a Hosted GitOps Runtime environment.

Before you begin

Verify that you have:

  • A Kubernetes cluster with access to the internet
  • An OAuth token

How to

  1. In the Codefresh UI, go to Codefresh Home Dashboard.

Hosted GitOps setup

Hosted GitOps setup
  1. Provision the Hosted GitOps Runtime:
    • Click Install, and wait for Codefresh to complete provisioning your Hosted GitOps Runtime (may take up to ten minutes).

Installing hosted runtime

Installing hosted runtime
  1. Select the Git organization for the runtime installation and the Shared Configuration Repo:
    • Click Connect.
    • Click Authorize Access and enter your OAuth token.
    • Select the Git Organization for which to create the repos.
    • Click Create. Codefresh creates the two Git repositories in the paths shown.

Connect to Git provider

Connect to Git provider
  1. Connect a K8s cluster:
    • Click Connect.
    • In the Add Managed Cluster panel, copy the command cf cluster add, and run it in the terminal.
    • When prompted to select the kube-context, select from the list of available clusters as defined in kubeconfig.
    • Verify that you have configured access to the required IP addresses required. See Codefresh IP addresses.

Connect a K8s cluster for hosted runtime

Connect a K8s cluster for hosted runtime
  1. Install Argo Rollouts on the cluster you added. You’ll need this to apply the rollout resource we will create for the application in the next task.
    • Go to Runtimes.
    • In either the List View or Topology View, click the name of the cluster on which to install Argo Rollouts.
    • Click + Install Argo Rollouts.

Install Argo Rollouts on managed cluster

Install Argo Rollouts on managed cluster

You are now ready to create and deploy an Argo CD application.

What to do next

Create resources for codefresh-guestbook application