Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
234 lines (183 sloc) 6.02 KB

Installation Guide

This document provides information on the installation of odo on various operating systems and the location of the binaries and the releases.

  • The latest odo binaries are available on Bintray.

  • The latest odo releases are available on Github.

Prerequisites

OpenShift 3.10.0 or above is required.

Installation methods for various operating systems

macOS

Using Homebrew Tap

  1. Access the repository using the Homebrew Tap as follows:

    $ brew tap kadel/odo
  2. Install from the latest Master build or the latest released version:

    • For the latest Master build use:

      $ brew install kadel/odo/odo --HEAD
    • For the latest released version use:

      $ brew install kadel/odo/odo

Binary installation

# curl -L https://github.com/openshift/odo/releases/latest/download/odo-darwin-amd64 -o /usr/local/bin/odo && chmod +x /usr/local/bin/odo

Tarball installation

# sh -c 'curl -L https://github.com/openshift/odo/releases/latest/download/odo-darwin-amd64.tar.gz | tar -xvzf - -C /usr/local/bin; chmod +x /usr/local/bin/odo'

Ubuntu or Debian

Using apt

  1. Add the GPG key from the Bintray used to sign repositories:

    $ curl -L https://bintray.com/user/downloadSubjectPublicKey?username=bintray | apt-key add -
  2. Add the repository to /etc/apt/sources.list:

    • For the latest Master builds use:

      $ echo "deb https://dl.bintray.com/odo/odo-deb-dev stretch main" | sudo tee -a /etc/apt/sources.list
    • For the latest signed releases use:

      $ echo "deb https://dl.bintray.com/odo/odo-deb-releases stretch main" | sudo tee -a /etc/apt/sources.list
  3. Install odo:

    # apt-get update
    # apt-get install odo

Binary installation

# curl -L https://github.com/openshift/odo/releases/latest/download/odo-linux-amd64 -o /usr/local/bin/odo && chmod +x /usr/local/bin/odo

Tarball installation

# sh -c 'curl -L https://github.com/openshift/odo/releases/latest/download/odo-linux-amd64.tar.gz | tar -xvzf - -C /usr/local/bin; chmod +x /usr/local/bin/odo'

Fedora, CentOS, or RHEL

Using yum or dnf

  1. Access the odo repository:

    • From the latest builds:

      1. Download the odo repository to /etc/yum.repods.d/ using:

        # curl -L https://bintray.com/odo/odo-rpm-dev/rpm -o /etc/yum.repos.d/bintray-odo-odo-rpm-dev.repo
      2. Verify the content of the file and ensure that you see the following:

        # cat /etc/yum.repos.d/bintray-odo-odo-rpm-dev.repo
        [bintraybintray-odo-odo-rpm-dev]
        name=bintray-odo-odo-rpm-dev
        baseurl=https://dl.bintray.com/odo/odo-rpm-dev
        gpgcheck=0
        repo_gpgcheck=0
        enabled=1
    • From the latest release:

      1. Download the odo repository to /etc/yum.repods.d/ using:

        # curl -L https://bintray.com/odo/odo-rpm-releases/rpm -o /etc/yum.repos.d/bintray-odo-odo-rpm-releases.repo
      2. Verify the content of the file and ensure that you see the following:

        # cat /etc/yum.repos.d/bintray-odo-odo-rpm-releases.repo
        [bintraybintray-odo-odo-rpm-releases]
        name=bintray-odo-odo-rpm-releases
        baseurl=https://dl.bintray.com/odo/odo-rpm-releases
        gpgcheck=0
        repo_gpgcheck=0
        enabled=1
  2. Install odo:

    • For CentOS or RHEL use:

      $ yum install odo
    • For Fedora use:

      $ dnf install odo

Binary installation

# curl -L https://github.com/openshift/odo/releases/latest/download/odo-linux-amd64 -o /usr/local/bin/odo && chmod +x /usr/local/bin/odo

Tarball installation

# sh -c 'curl -L https://github.com/openshift/odo/releases/latest/download/odo-linux-amd64.tar.gz | tar -xvzf - -C /usr/local/bin; chmod +x /usr/local/bin/odo'

Windows

  1. Download the latest file from the Bintray odo.exe or from the latest release page on GitHub.

  2. Extract the file and add the location of extracted binary to your GOPATH/bin directory (see below to create a Go binary directory)

Setting the PATH variable for Windows 7/8

The following example demonstrates how to set up a path variable. Your binaries can be located in any location but for the purpose of this example we will use C:\go-bin as the location.

  1. Create a folder at C:\go-bin.

  2. Right click on Start and click on Control Panel.

  3. Select System and Security and then click on System.

  4. From the menu on the left, select the Advanced systems settings and click the Environment Variables button at the bottom.

  5. Select Path from the Variable section and click Edit.

  6. Click New and type C:\go-bin into the field or click Browse and select the directory, and click OK.

Setting the PATH variable for Windows 10

You can edit Environment Variables faster using search as follows:

  1. Left click on Search and type env or environment.

  2. Select Edit environment variables for your account and follow steps 5 and 6 listed above.

Uninstalling odo from your system

To uninstall odo run the script installer.sh which is located in odo repository on GitHub.

  1. Run the script

    • If you don’t have the scipt locally on your machine:

      $ curl -L https://github.com/openshift/odo/raw/master/scripts/installer.sh | bash -s -- --uninstall
    • If you have the scipt locally on your machine:

      $ sh installer.sh --uninstall
  2. Delete local configuration and preference files from your home directory:

    $ rm -rf ~/.odo
You can’t perform that action at this time.