Home

Awesome

<!-- This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/. --> <!-- Copyright 2021 Joyent, Inc. Copyright 2022 MNX Cloud, Inc. -->

Triton DataCenter

Triton DataCenter (just "Triton" for short, formerly "SmartDataCenter" and "SDC") is an open-source cloud management platform that delivers next generation, container-based, service-oriented infrastructure across one or more data centers. With an emphasis on ease of installation and operation, Triton is proven at scale: Triton powers the Triton Cloud and private data centers (Triton Enterprise) worldwide.

This repository provides documentation for the overall Triton project and pointers to the other repositories that make up a complete Triton deployment. See the repository list.

Report bugs and request features using GitHub Issues. For additional resources, you can visit the Triton Developer Center.

Overview

A Triton DataCenter installation consists of two or more servers. All servers run SmartOS. One server acts as the management server, the head node, which houses the initial set of core services that drive Triton. The remainder are compute nodes (CNs) which run instances (containers and virtual machines).

Triton features:

Triton consists of the following components:

For more details, see:

Community

Community discussion about Triton DataCenter happens in two main places:

Getting Started

Cloud on a Laptop (CoaL)

An easy way to try Triton DataCenter is by downloading and installing a Cloud on a Laptop (CoaL) build. CoaL is a VMware virtual appliance that provides a full Triton head node for development and testing.

The CoaL Setup document contains detailed instructions for downloading and installing the virtual appliance. If you use the ISO installer (see below) on a Virtual Machine, the CoaL setup instructions post-booting should be followed as well.

If you already have a CoaL and would like to update the installation, follow the instructions for [updating a Triton standup using sdcadm.

ISO Installer

The ISO installer page contains information on the ISO installer. With SmartOS now able to boot off a ZFS pool, the Triton Head Node can do the same.

iPXE installer

Some deployment environments install new hardware using an iPXE boot. An iPXE boot directory for a Triton Head Node can install Triton using an iPXE installation.

Installing Triton on a Physical Server

A Triton DataCenter server runs SmartOS which is a live image. That live image, which generates a ramdisk root with many portions set to read-only, can boot from a USB flash drive (a physical USB key), or a ZFS pool. To install a USB-key Triton, first obtain the latest release USB build. Otherwise, given the cautions in the ISO installer page, a physical server can boot off of its zones pool.

Both USB-key-boot and ZFS-pool-boot use the same interfaces within Triton, with a ZFS bootable filesystem substituting for the USB-key.

Hardware

For Triton development only, the minimum server hardware is:

Hardware RAID is not recommended. Triton will lay down a ZFS ZPOOL across all available disks on install. You'll want much more storage if you're working with images and instances. If you are using an ISO or iPXE installation, configure a simple layout of disks (e.g. mirrored pair, or single raidz group).

If setting up a Triton DataCenter pilot then you'll want to review the Hardware Selection Requirements, Networking Layout Requirements, and Installation Prerequisites which include IPMI and at least 10 gigabit Ethernet. The supported hardware components for SmartOS are described in the SmartOS Hardware Requirements. certified hardware for Triton DataCenter are all in the Triton Manufacturing Database.

Install

To install a USB-key Triton, first download the latest release image:

curl -C - -O https://us-central.manta.mnx.io/Joyent_Dev/public/SmartDataCenter/usb-latest.tgz

Once you have downloaded the latest release image, you will need to write it to a USB key boot the head node server using the USB key, and follow the install prompts. All steps necessary to plan, install, and configure Triton DataCenter (Triton) are available in the customer documentation Installing Triton Data Center.

To install using the ISO installer, download the ISO image, make sure you be aware of the available disks, and then follow the installation instructions above.

To install using the iPXE installer, follow the advice on the iPXE installer documentation.

Building

Triton is composed of several pre-built components:

Each component is built separately and then all are combined into CoaL, USB, ISO, and iPXE builds (see the preceding sections) via the sdc-headnode repository. The built components are typically stored in a Manta object store, and pulled from there. For example, Triton builds push to /Joyent_Dev/public/builds in our public Manta in us-central-1 (https://us-central.manta.mnx.io/).

You can build your own CoaL and USB images on Mac or SmartOS (see the sdc-headnode README). However, ISO and iPXE images, as well as all other Triton components must be built using a running Triton or in a local CoaL). See the building document for details on building each of the Triton components.

Contributing

To report bugs or request features, submit issues here on GitHub, TritonDataCenter/triton/issues (or on the GitHub issue tracker for the relevant project). For support of Triton products and services, please contact MNX Solutions customer support instead.

See the Contribution Guidelines for information about contributing changes to the project.

Design Principles

Triton DataCenter is very opinionated about how to architect a cloud. These opinions are the result of many years of deploying and debugging Triton as a public cloud service in production. Design principles include the following:

The goals behind the design of Triton services include:

Dependencies and Related Projects

Triton DataCenter uses SmartOS as the host operating system. The SmartOS hypervisor provides both SmartOS zone (container) and KVM virtualization.

Triton's open-source Manta project is an HTTP-based object store with built-in support to run arbitrary programs on data at rest (i.e., without copying data out of the object store). Manta runs on and integrates with Triton DataCenter.

License

Triton DataCenter is licensed under the Mozilla Public License version 2.0. See the file LICENSE. SmartOS is licensed separately.