Skip to content

Installation

Controller Installation

kubectl create namespace argo-rollouts
kubectl apply -n argo-rollouts -f https://raw.githubusercontent.com/argoproj/argo-rollouts/stable/manifests/install.yaml

This will create a new namespace, argo-rollouts, where Argo Rollouts controller will run.

Tip

When installing Argo Rollouts on Kubernetes v1.14 or lower, the CRD manifests must be kubectl applied with the --validate=false option. This is caused by use of new CRD fields introduced in v1.15, which are rejected by default in lower API servers.

Tip

On GKE, you will need grant your account the ability to create new cluster roles:

kubectl create clusterrolebinding YOURNAME-cluster-admin-binding --clusterrole=cluster-admin --user=YOUREMAIL@gmail.com

Kubectl Plugin Installation

The kubectl plugin is optional, but is convenient for managing and visualizing rollouts from the command line.

Brew

brew install argoproj/tap/kubectl-argo-rollouts

Manual

  1. Install Argo Rollouts Kubectl plugin with curl.

    curl -LO https://github.com/argoproj/argo-rollouts/releases/latest/download/kubectl-argo-rollouts-darwin-amd64
    

    For Linux dist, replace darwin with linux

  2. Make the kubectl-argo-rollouts binary executable.

    chmod +x ./kubectl-argo-rollouts-darwin-amd64
    
  3. Move the binary into your PATH.

    sudo mv ./kubectl-argo-rollouts-darwin-amd64 /usr/local/bin/kubectl-argo-rollouts
    

Test to ensure the version you installed is up-to-date:

kubectl argo rollouts version