Skip to content

Create datum-concepts.md #29

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions content/en/docs/get-started/datum-concepts.md
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Styling request - We don't have a linter for this yet, but could we keep line length at 80 characters to help with reviewing content? It'd allow for more targeted comments and recommended changes.

If helpful, I use the Rewrap plugin in VSCode to help me with this - it allows me to select a block of text and wrap it at an arbitrary length. Another helpful plugin to use is the Markdown All in One plugin package.

Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
---
title: "Key Concepts for Using Datum"
linkTitle: "Key Concepts for Using Datum"
weight: 100
description: >-
This page describes key concepts for working with the Datum Cloud.
---

## The Datum Control Plane

The Datum Operator is implemented upon Kubernetes Custom Resource Definitions (CRDs) to provide abstracted, yet orchestrated, functionality across Hyperscale Cloud Providers, Network as a Service Operators, Edge Clouds (including our own), and infrastructure under your management and control.

By implementing an operator based on top of Kubernetes CRDs, we leverage common patterns familiar to developers, SREs, and Platform Engineers. Using the Datum Operator, you describe your desired system state through manifests, and the Datum Operator will deploy and continuously validate global operational state against that manifest.

Datum (will) supports bi-directional control plane federation, from the Datum Cloud to 1st or 3rd party compute platforms so that you can bring Datum anywhere you need it. At this point in time, Datum supports compute resources backed by GCP and network resources from our own Edge Cloud.

## Helpful Tools

### Datum Portal - cloud.datum.net

The [Datum Portal](https://cloud.datum.net) provides real-time insights on the state of your Datum Control Plane resources.

### Datum's Command Line Tool - datumctl

[datumctl](https://docs.datum.net/docs/tasks/tools/#datumctl) is our CLI for managing the Datum Control Plane via the command line. datumctl provides authorization, API management, and has the ability to manage .kubeconfig files so that one can leverage kubectl for day to day interaction with Datum Cloud.

## Key Components

### Datum Workloads

Datum Workloads are where the magic of Datum happens. Workloads are defined using Kubernetes Manifests. Workloads can be Virtual Machines or Containers, that are deployed as collections of instances across the Locations you define with "Superpowers" delivered through Datum Cloud Networks (more on both topics below). The Datum Operator is responsible for taking your workload manifest definition, and ensuring its running state across Locations and Networks.

### Datum Locations

Datum Locations are used to define available resources from Hyperscale Cloud Providers, Network as a Service Operators, Edge Clouds (including our own), and infrastructure under your management and control. Use locations to define available infrastructure for consumption by workloads.

### Datum Networks

Datum Networks are "galactic VPCs" that can span among Hyperscale Cloud Providers, Network as a Service Operators, Edge Clouds (including our own), and infrastructure under your management and control. Datum Cloud networks are virtualized and can be created for your simple convenience, logical organization needs, and operational security / segmentation concerns. Datum Cloud Networks are programatically organized and applied throughout the system to reduce operator cognitive load. Datum Networks are designed to provide rich observability and telemetry capabilities.