Install Tools for Deployment
Learn how to install the necessary tools for deploying the application
Overview
You will learn
- How to install the tools required for deploying CAP applications in the SAP BTP, Kyma runtime.
- kubectl
- kubelogin
- helm
- pack
- A container management app such as Docker Desktop or Rancher Desktop.
Prerequisites
Prerequisites
- You’ve configured the respective entitlements, enabled the Kyma runtime in your subaccount, and created an SAP HANA Cloud service instance in the SAP BTP cockpit. Follow the steps in the Setting Up SAP BTP and Kyma Runtime for Deployment tutorial that is part of the Application Lifecycle Management using CAP Operator tutorial group.
- You have an enterprise global account in SAP BTP. To use services for free, you can sign up for an SAP BTPEA (SAP BTP Enterprise Agreement) or a Pay-As-You-Go for SAP BTP global account and use the free tier services only. See Using Free Service Plans.
- You have a platform user. See User and Member Management.
- You’re an administrator of the global account in SAP BTP.
- You have a subaccount in SAP BTP to deploy the services and applications.
- For Windows, you need Chocolatey. Chocolatey is a package manager that speeds up and eases installation of the tools in this tutorial. See how to install Chocolatey in Setup/Install.
- You’ve prepared a container registry and you’ve logged in to the container registry through your CLI. A container registry is a repo where you can push your Docker images. You can use any container registry offering as long as it can be reached from the public internet. In case if you don’t have access to a container registry, you can make use of the Docker Registry Community Module from Kyma.
Steps
Choose
KubeconfigURLunder the Kyma Environment tab in your subaccount.
Kubeconfig URL A
kubeconfig.yamlfile is downloaded.
Kubeconfig yaml Copy the
kubeconfig.yamlfile to the~/.kube/directory and rename it toconfig. Replace or rename any existing file with the same name.
There are two additional steps for Windows users only:
Go to
C:\ProgramData\chocolatey\bin.Rename
kubelogin.exetokubectl-oidc_login.exe.
Kyma runs on containers. For this tutorial, you need an application that enables you to manage container images on your desktop (build, push, pull, and run) and a Docker-compatible command-line interface. We provide two examples - Docker Desktop and Rancher Desktop. You can choose one of these or any other app suitable for this purpose.
macOS: Download the installer from Install Docker Desktop on Mac and follow the instructions to install and set up Docker Desktop.
Windows: Download the installer from Install Docker Desktop on Windows and follow the instructions to install and set up Docker Desktop.
Kyma runs on containers. For this tutorial, you need an application that enables you to manage container images on your desktop (build, push, pull, and run) and a Docker-compatible command-line interface. We provide two examples - Docker Desktop and Rancher Desktop. You can choose one of these or any other app suitable for this purpose.
macOS:
Go to the releases page.
Download the Rancher Desktop installer for macOS.
The macOS installer is called
Rancher.Desktop-<version.architecture>.dmg. Here’s an example with the current latest version:Rancher.Desktop-1.2.1.x86_64.dmg.Run the installer. When the installation is complete, drag the Rancher Desktop icon to the Applications folder.
You can find details about installation requirements and steps to install or uninstall in macOS.
Windows:
Go to the releases page.
Download the Rancher Desktop installer for Windows.
The Windows installer is called
Rancher.Desktop.Setup.<version>.exe. Here’s an example with the current latest version:Rancher.Desktop.Setup.1.2.1.exe.Run the installer. When the installation is complete, choose Finish.
You can find details about installation requirements and steps to install or uninstall in Windows.
Linux: There are several ways to install Rancher Desktop on Linux. You can find details about installation requirements and steps to install or uninstall in Linux.
Resources
Discussion
Share feedback on this tutorial or join the conversation in SAP Community.