1.3. Cloud & VM Install (Non-PXE environments)¶
This Cloud install guide provides a multi-cloud management focused installation process that runs DRP inside a Cloud Provider using Resource Brokers.
Other installation paths:
Production Install details more complex installs including offline/airgap.
Developer Install (Console Isolated) for developers running DRP interactively
Container Install (Docker/Podman) for trial users minimizing their install requirements
Edge Lab with RPi is self-contained Digital Rebar inexpensive lab using Raspberry Pi computers.
Unlike other environments which requires careful setup up of your network environment and consideration with regard to competing DHCP services, this setup does not use DHCP or PXE provisioning.
You must install Digital Rebar to use it, there is no SaaS version. Why do I have to install Digital Rebar locally?
Acquire a Linux Cloud or Virtual instance. It should have at least 4 Gb or RAM and 20 Gb of storage available for a long term system. Short term trials can use as little as 1 CPU and 1 Gb of RAM.
You must provide access to TCP/8092, TCP/8091 and TCP/8090 (default ports) to access Digital Rebar. Openning ports varies depending on the provider.
To begin, execute the following commands in an SSH session or during instance cloud-init process:
The example is for AWS clouds because using it’s API to get the public IP address for Digital Rebar. For other clouds, replace the API call with the one for that platform or manually provide the public IP.
#!/usr/bin/env bash # AWS specific API call value=$(curl -sfL http://169.254.169.254/latest/meta-data/public-ipv4) # Google: value=$(curl -sfL -H "Metadata-Flavor: Google" http://metadata/computeMetadata/v1/instance/network-interfaces/0/access-configs/0/external-ip) # Azure: value=$(curl -H Metadata:true --noproxy "*" "http://169.254.169.254/metadata/instance/network/interface/0/ipv4/ipAddress/0/publicIpAddress?api-version=2021-05-01&format=text") # Digital Ocean: value=$(curl -sfL curl http://169.254.169.254/metadata/v1/interfaces/public/0/ipv4/address) curl -fsSL get.rebar.digital/stable | sudo bash -s -- install --universal --version=tip --ipaddr=$value
The command will download the tip Digital Rebar (the
systemctl service name is
dr-provision) bundle and checksum from github, extract the files, verify prerequisites are installed, and create needed directories and links under
--version flags included for clarity, they are not required for this install.
The install script used by our installs has many additional options including
remove that are documented in its help and explored in other install guides.
Once the installation script completes, a Digital Rebar endpoint will be running your instance!
Follow the steps in UX System Bootstrap Wizard to registered your Digital Rebar endpoint.
1.3.3. Clusters and Brokers¶
These instructions apply to v4.8 and later.
Universal installation automatically build the correct container infratructure for cloud clusters and brokers.
Create a resource broker using one of the cloud resource profiles. The UX wizard will assist you in selecting a cloud resource profile and adding the required configuration parameters.
Create a cluster via the UX cluster wizard and select your broker. The system will automatically create the machines to back the cluster using a generated Terraform plan based on your broker inputs.
1.3.4. Clean Up¶
Once you are finished exploring Digital Rebar Provision in the cloud, cleanup any clusters that you created (that will remove the created VMs) and then remove the instance.