Maya Protocol One-Stop-Shop
  • Introduction
    • 🍫What is Maya Protocol?
      • Getting Started
      • Roles
        • Liquidity Providers
        • Swappers
        • Arbitrageurs
        • Node Operators
      • Maya Protocol Native Assets
    • 🌐Maya Ecosystem
      • User interfaces & Wallets
      • Tools
    • 🍫How to buy CACAO?
    • πŸ›£οΈRoadmap 2025
  • Deep Dive
    • πŸšΆβ€β™‚οΈStep-by-Step Guides
      • Set up a MAYAChain wallet
        • Using El Dorito Club
        • Using THORWallet web APP
        • Using THORWallet Mobile APP
        • Through MAYANode cli
        • By importing Ledger hard wallet into Ctrl Wallet
      • Custom Memos
        • Swap
        • Add Liquidity
        • Withdraw Liquidity
    • πŸ› οΈHow It Works
      • Technology
      • Incentive Curve
      • Fees
      • Governance
      • Constants and Mimir
      • Security
      • Dynamic Inflation
      • Liquidity Nodes
      • Impermanent Loss Protection (ILP)
      • ELI5
        • What is Threshold Signature Scheme (TSS)?
    • πŸ’΅DeFi Products
      • Synthetics
      • Liquidity
    • πŸ”Audits
    • 🎭Maya Masks
    • ❓FAQs
  • Blockchain Explorer
    • πŸ”ŽMayaScan
      • πŸͺ™MRC-20 Tokens
      • πŸ–ΌοΈM-NFTS
  • Airdrop
    • πŸͺ‚$MAYA Airdrops Guide
  • Media
    • πŸ“½οΈAaluxx Interviews
    • 🐦Twitter Spaces
    • πŸ”—Links
  • Contribute
    • 😎Ambassador Program
    • 🎨Content Creators Guide
  • Node Docs
    • πŸ–₯️MAYANodes
      • MAYANode Overview
      • Cluster Launcher
        • Setup - Linode
        • Setup - Azure
        • Setup - Hetzner Bare Metal
        • Setup - Google Cloud
        • Setup - HCloud
        • Setup - Digital Ocean
        • Setup - AWS
      • Deploying
      • Joining
      • Managing
      • Pooled MAYANodes
      • Alerting
      • Leaving
      • πŸ›‘Emergency Procedures
      • βœ”οΈ CHECKLIST
      • Multi-node Deployment
      • Fullnode Installation Guide
    • Bonding & Unbonding Guide
    • Bare Metal Node Guides
  • MAYACHAIN DEV DOCS
    • Introduction
      • MAYAName Guide
      • Swapping Guide
        • Quickstart Guide
        • Fees and Wait Times
        • Streaming Swaps
      • Add MAYAChain to your Wallet
    • Examples
      • Tutorials
      • Typescript (XChainJS) WIP
        • Query Package
        • AMM Package
        • Client Packages
        • Packages Breakdown
        • Coding Guide
      • SwapKit SDK
    • Concepts
      • Connecting to MAYAChain
      • Querying MAYAChain
      • Transaction Memos
      • Asset Notation
      • Memo Length Reduction
      • Network Halts
      • Fees
      • Delays
      • Sending Transactions
      • Math
    • Aggregators
      • Memos
      • EVM Implementation
    • CLI
      • Multisig
      • Offline Ledger Support
    • Protocol Development
      • Adding New Chains
      • Chain Clients
        • UTXO
        • EVM Chains
        • Cosmos Chains
      • ERC-20 Tokens
      • THORChain Version Updates I
      • THORChain Version Updates II
  • White Paper
    • πŸ“–Maya Whitepaper 2.0
      • Introduction
      • 🍫Fair Launch
        • Philosophical perspective FL
        • Economic overview FL
        • Technical overview FL
      • πŸͺ™$MAYA token
        • Philosophical perspective MT
        • Economic overview MT
        • Technical overview MT
      • 🌊Liquidity Nodes
        • Philosophical perspective LN
        • Economic overview LN
        • Technical overview LN
      • πŸ”’Security Nodes
        • Philosophical perspective SN
        • Economic overview SN
        • Technical overview SN
      • πŸ”΄Aztec Chain & $AZTEC token
        • Philosophical perspective AC
        • Economic overview AC
        • Technical overview AC
      • βš–οΈStable Pools & Route Optimization
        • Philosophical perspective RO
        • Economic overview RO
        • Technical overview RO
      • πŸ‘£Roadmap. Maya 3.0
        • Philosophical perspective 3.0
        • Economic overview 3.0
        • Technical overview 3.0
  • Website
  • GitLab
  • Archive
    • Liquidity Auction
    • THORChads Airdrop
    • Add ETH, USDC, or USDT through THORWallet using Metamask + Ledger
    • $MAYA Airdrop for Maya Mask Holders
    • Maya Integration Guide
    • Roadmap 2023
Powered by GitBook

Social Media

  • Twitter
  • Telegram
  • Discord
On this page
  • Deploy an umnanaged Kubernetes cluster in hcloud
  • Requirements
  • Steps
  • Environment
  • Deploy Kubernetes Cluster
  • Quotas
  • CONFIGURE

Was this helpful?

Export as PDF
  1. Node Docs
  2. MAYANodes
  3. Cluster Launcher

Setup - HCloud

Setting up a Kubernetes Cluster with Hetzner Cloud (hcloud)

PreviousSetup - Google CloudNextSetup - Digital Ocean

Last updated 2 years ago

Was this helpful?

Deploy an umnanaged Kubernetes cluster in hcloud

This approach is only recommended for experienced operators because the kubernetes control plane among other things needs to be managed manually.

Requirements

  1. hcloud account

  2. hcloud and hcloud credentials configured

  3. kubectl

  4. ansible

LINUX/MAC is the preferred method of setup.

Windows should choose either:

  1. Deploy a MAYANode from a Linux VPS.

  2. Use Windows Subsystem for Linux - ****

Steps

Firstly, clone and enter the . All commands in this section are to be run inside this repo.

git clone https://gitlab.com/mayachain/devops/cluster-launcher
cd cluster-launcher

Install Terraform:

brew install terraform

hcloud CLI

brew install hcloud
hcloud context create <project_name>

You will be asked for you Personal Access Token with read/write priveleges (retrieve from API Panel from the hcloud web console.)

API -> Tokens/Keys -> Create Token.

Make sure you handle your secrets securely!

Kubernetes Control Tool

brew install kubernetes-cli

wget && jq

brew install wget
brew install jq

Environment

Initialize the git submodule.

git submodule update --init

Use direnv, venv or whatever you prefer to manage a python environment inside the hcloud folder.

# Optional
(cd hcloud && direnv allow)

# Optional
(cd hcloud && virtualenv -p python3 venv)

Install dependencies required by Python and Ansible Galaxy.

(cd hcloud && pip install -r ansible/requirements.txt)
(cd hcloud && ansible-galaxy install -r ansible/requirements.yml)

Deploy Kubernetes Cluster

Use the commands below to deploy an hcloud cluster:

make hcloud

During the deploy, you will be asked to enter information about your cluster:

var.name
  The base name used for all resources

  Enter a value: ma-k8s

var.token
  Hetzner Cloud API token

  Enter a value: <secret>

var.user_name
  The admin user name for the nodes

  Enter a value: admin
  • Name

  • Token

  • Confirm yes

Deploying a cluster takes ~15 minutes

Quotas

CONFIGURE

Now that you've provisioned your hcloud cluster, you need to configure kubectl. Customize the following command with your cluster name and resource group. It will get the access credentials for your cluster and automatically configure kubectl.

(cd hcloud && scp $(terraform output -raw hcloud_config) ~/.kube/config-hcloud)

# Merge it and set current context
KUBECONFIG=~/.kube/config:~/.kube/config-hcloud kubectl config view --flatten > ~/.kube/tmpcfg && mv -f ~/.kube/tmpcfg ~/.kube/config && kubectl config use-context $(kubectl config current-context --kubeconfig=$HOME/.kube/config-hcloud)

kubectl version

You are now ready to deploy a MAYANode.

Then install the :

The allows you to manage your hcloud services.

Use the package manager to install the hcloud CLI.

You must install and configure the Kubernetes CLI tool (kubectl). **To install kubectl** , follow , or choose a package manager based on your operating system.

Use the package manager to install kubectl.

You also need wget and jq, follow , or choose a package manager based on your operating system.

Use the package manager to install wget and jq Note: You most likely have these installed already.

If necessary, request a quota increase .

πŸ–₯️
https://docs.microsoft.com/en-us/windows/wsl/about
cluster-launcher repository
terraform CLI
hcloud CLI
homebrew
these instructions
homebrew
these instructions
homebrew
here