How to Install Knative CLI on a Vultr Cloud Server

Introduction

Knative CLI (kn) is a terminal based tool that allows you to deploy and manage Knative services in a Kubernetes Cluster without creating YAML files. It offers a user friendly command line interface and uses existing Kubectl configurations to connect to a Kubernetes cluster. Follow the steps in this article to install Knative CLI on a Vultr Cloud Server.

Prerequisites

Before you begin:

• Deploy a Linux Server on Vultr

• Using SSH, access the server

• Create a non-root user with sudo privileges

• Switch to the new non-root user account

    # su - sysadmin

Install Knative CLI

To install the Knative CLI tool on your server, you can either use a release binary file or Go. To install the latest version, it's recommended to use the Golang method while the release binary file allows you to implement a specific version on your choice. Depending on your choice, install Knative CLI as described in the steps below.

Install Knative CLI using the Latest Release Binary File

1. Download the latest Knative CLI latest release file

    $ wget https://github.com/knative/client/releases/download/knative-v1.11.0/kn-linux-amd64

   The above command downloads version v1.11.0, visit the Knative Client releases page to verify the latest version to install on your server

2. Move the downloaded kn-linux-amd64 binary file to the /usr/local/bin/ directory and rename it to kn to enable it as a system wide command

    $ sudo mv kn-linux-amd64 /usr/local/bin/kn

3. Enable execution privileges on the kn binary file

    $ sudo chmod +x /usr/local/bin/kn

4. Switch to your user home directory

    $ cd

5. Verify the installed Knative CLI version

    $ kn version

   Your output should look like the one below:

    Version:      v20231007-local-807181fb
    Build Date:   2023-10-07 18:06:36
    Git Revision: 807181fb
    Supported APIs:
    * Serving
      - serving.knative.dev/v1 (knative-serving v0.38.1-0.20230921205527-0d73dfe0f295)
    * Eventing
      - sources.knative.dev/v1 (knative-eventing v0.38.1-0.20230921080814-ceecbb01e116)
      - eventing.knative.dev/v1 (knative-eventing v0.38.1-0.20230921080814-ceecbb01e116)

   You have installed the Knative CLI tool using the official binary release file. Run kn --help to view the list of commands you can run using the tool

Install Knative CLI using Go

1. Install the Golang package on your server

   Ubuntu/Debian Systems:

    $ sudo apt install golang

   CentOS/RockyLinux/AlmaLinux/RHEL Systems:

    $ sudo dnf install golang

2. Verify the installed Go version

    $ go version

   Output:

    go version go1.20.3 linux/amd64

3. Clone the Knative Client repository

    $ git clone https://github.com/knative/client.git

4. Switch to the new client directory

    $ cd client

5. List files and verify that Knative files are available in the directory

    $ ls

   Output:

    CHANGELOG.adoc  CODE-OF-CONDUCT.md  CONTRIBUTING.md  DEVELOPMENT.md  go.mod  hack  LICENSE  OWNERS_ALIASES  README.md  third_party  vendor
    cmd             config              conventions      docs            go.sum  lib   OWNERS   pkg             test       tools

6. Build a new executable binary file

    $ hack/build.sh -f

   Output:

    🚧 Compile

7. A new kn binary file is added to your directory. Move the file to your system path /usr/local/bin/ to activate it as a system-wide command

    $ sudo mv kn /usr/local/bin/

8. Switch to your user home directory

    $ cd

9. Verify the installed Knative CLI version

    $ kn version

   Your output should look like the one below:

    Version:      v20231007-local-807181fb
    Build Date:   2023-10-07 18:06:36
    Git Revision: 807181fb
    Supported APIs:
    * Serving
      - serving.knative.dev/v1 (knative-serving v0.38.1-0.20230921205527-0d73dfe0f295)
    * Eventing
      - sources.knative.dev/v1 (knative-eventing v0.38.1-0.20230921080814-ceecbb01e116)
      - eventing.knative.dev/v1 (knative-eventing v0.38.1-0.20230921080814-ceecbb01e116)

Install Knative CLI on a Vultr Windows Server

To install the Knative CLI tool on a windows server instead of a Linux server, download the latest release file and install it on your system as described in the steps below.

• Deploy a Windows Server on Vultr
• Using RDP, access the server as an administrative user

1. Start a new web browser session, and visit the Knative Client releases page

    https://github.com/knative/client/releases/

2. Click the latest release. For example v1.11.0 to view the release files

3. Scroll to the Assets section and click to download the kn-windows-amd64.exe file

   

4. When the download process is complete, open a new File Explorer window and navigate to the Downloads folder

5. Find the kn-windows-amd64.exe file, right-click, and select Rename from the list

   

6. Rename the file to kn and press Enter to save the new filename

7. Navigate to the Windows start menu, expand the Windows System group and click Command Prompt to start a new command line session

8. In the Windows Command prompt window, enter the following command and press Enter to switch to the C:/ drive directory

    > cd C:/

9. Create a new folder Knative in the C:/ location

    > mkdir Knative

10. Move the downloaded Knative kn.exe release file from your Downloads directory to the new Knative directory

    > move C:\Users\Administrator\Downloads\kn.exe C:\Knative

11. View files in the Knative directory

    > dir

    Output:

    Directory of C:\Knative
    
    10/07/2023  06:57 PM    <DIR>          .
    10/07/2023  06:29 PM        72,081,920 kn.exe
                   1 File(s)     72,081,920 bytes
                   1 Dir(s)  55,225,864,192 bytes free

    Verify that the kn.exe file is available in the directory

12. Add the Knative folder to your Windows system commands path

    > setx PATH "%PATH%;C:\Knative" /M

13. Close your Windows Command Prompt and open it again to start a new session

14. View the system paths and verify that the Knative directory is available on the list

    > PATH

    Your output should look like the one below:

    C:\Knative; C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Windows\System32\OpenSSH\;C:\Users\Administrator\AppData\Local\Microsoft\WindowsApps;

15. Run the kn command and verify the installed Knative CLI version

    > kn version

    Output:

    Version:      v20231007-local-807181fb
    Build Date:   2023-10-07 18:06:36
    Git Revision: 807181fb
    Supported APIs:
    * Serving
      - serving.knative.dev/v1 (knative-serving v0.38.1-0.20230921205527-0d73dfe0f295)
    * Eventing
      - sources.knative.dev/v1 (knative-eventing v0.38.1-0.20230921080814-ceecbb01e116)
      - eventing.knative.dev/v1 (knative-eventing v0.38.1-0.20230921080814-ceecbb01e116)

You have installed the Knative CLI tool on your Windows Server. You can use the tool in any directory within your Windows command prompt session. To view a list of available commands, add the --help option to the kn command

Test the Knative CLI Tool

To verify that the Knative CLI tool is working correctly on your server, view the list of available commands and create a new service as described below.

1. Verify that your Kubectl configuration is connected to a Kubernetes Cluster

    $ kubectl get nodes

2. View the list of available Knative CLI commands

    $ kn --help

   Output:

    Serving Commands:
    service      Manage Knative services
    revision     Manage service revisions
    route        List and describe service routes
    domain       Manage domain mappings
    container    Manage service's containers (experimental)
   
    Eventing Commands:
    source       Manage event sources
    broker       Manage message brokers
    trigger      Manage event triggers
    channel      Manage event channels
    subscription Manage event subscriptions
    eventtype    Manage eventtypes
   
    Other Commands:
    plugin       Manage kn plugins
    secret       Manage secrets
    completion   Output shell completion code
    version      Show the version of this client
   
   
    Use "kn <command> --help" for more information about a given command.
    Use "kn options" for a list of global command-line options (applies to all commands).

3. Create a new Knative Service using a Docker image. Replace hello-world with your desired image

    $ kn service create sample-service --image hello-world

4. Describe the service to view detailed information on its status

    $ kn service describe sample-service

Conclusion

You have installed the Knative CLI tool on a Vultr Cloud Server. When deployed on your server, the tool uses your Kubectl configurations to connect to your cluster and create serverless applications. For mroe information about Knative CLI, visit the official documentation page.

Next Steps

To implement more Knative solutions, visit the following resources:

• Deploy Serverless Workloads on Vultr Kubernetes Engine with Knative Serving
• Build Event Driven Applications on Vultr Kubernetes Engine with Knative Eventing