Skip to main content

Introduction and Setup

This topic provides a summary of the goals and outcomes for the tutorial and also lists the prerequisites to set up your environment before you begin.

Summary​

This tutorial introduces you to installing an application on a Linux virtual machine (VM) using Replicated Embedded Cluster. Embedded Cluster allows you to distribute a Kubernetes cluster and your application together as a single appliance, making it easy for enterprise users to install, update, and manage the application and the cluster in tandem.

In this tutorial, you use a sample application to learn how to:

  • Add the Embedded Cluster Config to a release
  • Use Embedded Cluster to install the application on a Linux VM

Set Up the Environment​

Before you begin, ensure that you have access to a VM that meets the requirements for Embedded Cluster:

  • Linux operating system
  • x86-64 architecture
  • systemd
  • At least 2GB of memory and 2 CPU cores
  • Disk space requirements:
    • The filesystem at /var/lib/embedded-cluster has 40Gi or more of total space
    • The filesystem at /var/lib/k0s has 40Gi or more of total space and must be no more than 80% full
    • The filesystem at /var/openebs has 5Gi or more of total space
    • The filesystem at /tmp has 5Gi or more of total space
  • (Online installations only) Access to replicated.app and proxy.replicated.com or your custom domain for each
  • Embedded Cluster is based on k0s, so all k0s system requirements and external runtime dependencies apply. See System requirements and External runtime dependencies in the k0s documentation.

Next Step​

Install the Replicated CLI and create an application in the Replicated Vendor Portal. See Step 1: Create an Application.