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