Glossary¶
Note
This is a collection of terms used in the CoCalc documentation. The included links point to original sources for more details.
Here are starting point for learning more about
Kubernetes: https://kubernetes.io/docs/home/
Linux: https://linuxjourney.com/
- Air-gapped Environment¶
An air-gapped environment is a secure computer network that is physically isolated from unsecured networks, such as the public Internet or an unsecured local area network.
- AKS¶
Azure Kubernetes Service (AKS) is a managed Kubernetes service that lets you quickly deploy and manage clusters.
- AWS¶
Amazon Web Services is a secure cloud services platform, offering compute power, database storage, content delivery and other functionality to help businesses scale and grow.
- AWS S3¶
Amazon Simple Storage Service (Amazon S3) is an object storage service that offers industry-leading scalability, data availability, security, and performance.
- Bare metal¶
A “bare metal” Kubernetes cluster is a cluster that is not running on a cloud provider, but on a set of physical machines.
- Certificate Manager¶
cert-manager is a Kubernetes add-on to automate the management and issuance of TLS certificates from various issuing sources.
- ClusterIP¶
Each Service can be reached by that internal IP address. However, if set to
"None"
, no address is allocated and its now a “headless” service. The traffic to this service will be handled by the Ingress Controller.- CoCalc¶
CoCalc is a web-based platform for creating, editing, and collaborating on Jupyter Notebooks, LaTeX documents, Linux Terminals, and more.
- ConfigMap¶
A ConfigMap is an object stored in Kubernetes that contains configuration data.
- Container¶
A Kubernetes container is a standard unit of software that packages up code and all its dependencies so the application runs quickly and reliably from one computing environment to another. See Container for more information.
- Deployment Hook¶
HELM Deployment Hooks are used to run a job before or after a deployment.
- Device Plugin¶
A Device Plugin is a plugin that enables Kubernetes to manage hardware resources like GPUs.
- Docker Credentials¶
In Kubernetes, it is possible to configure a secret, that contains the credentials for a private Docker registry. See Docker Credentials for more information.
- Docker Images¶
Docker images are a way to deliver software in packages and run them in containers. See Docker for more information.
- EKS¶
Amazon Elastic Kubernetes Service (EKS) is a managed service that makes it easy for you to run Kubernetes on AWS without needing to install and operate your own Kubernetes clusters.
- GID¶
Group Identifier: a unique numerical value assigned to each group in a system. It is used to manage permissions and access levels for a group of users, determining their collective access to system resources. See also UID and UID/GID.
- Git¶
Git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency. See Git for more information.
- GKE¶
Google Kubernetes Engine (GKE) is a managed, production-ready environment for deploying containerized applications.
- GNU Autotools¶
GNU Autotools are a set of programming tools to assist in making source code packages portable to many Unix-like systems.
- Google Cloud Storage¶
Google Cloud Storage is a unified object storage for developers and enterprises, from live data serving to data analytics/ML to data archiving.
- Google Compute Platform¶
Google Compute Platform is a suite of cloud computing services that runs on the same infrastructure that Google uses internally for its end-user products, such as Google Search and YouTube.
- GPU¶
A GPU is a specialized hardware, coming from the graphics card industry, that is used for general purpose computation. To make it useful in a Kubernetes cluster, it needs to be exposed to the cluster as a device plugin and then be requested by a pod. See NVIDIA GPU for more information.
- HELM¶
Helm is kind of a package manager for Kubernetes. Those “packages” are organized as HELM Charts.
- HELM Charts¶
A Helm Chart is a collection of files that describe a related set of Kubernetes resources.
- HELM Diff¶
Helm Diff is a Helm plugin that shows a diff explaining what a helm upgrade would change.
- HELM sub-charts and global values¶
Helm sub-charts and global values help organizing larger sets of charts. Globals are used to share values between charts. See Subcharts and Globals for more information. Any value can be set from a single central configuration file of yours.
- Home Directory¶
In Linux and other Unix-like operating systems, a home directory is a directory where a user’s personal files are stored. It’s usually in
/home/<username>
. Specific to CoCalc, the username isuser
and has the UID/GID2001:2001
.- IdP¶
An Identity Provider (IdP) is a system entity that creates, maintains, and manages identity information for users while providing authentication services to applications. It enables SSO capabilities, allowing users to authenticate once and gain access to multiple applications without needing to log in again. Common examples include Google, Facebook, and enterprise identity systems.
- Ingress¶
Ingress is a collection of rules that allow inbound connections to reach their corresponding cluster service endpoints.
- Ingress TLS¶
Ingress TLS configures the TLS keys and certificates to use for the Ingress.
- Init Container¶
An Init Container runs before the actual containers are created and started up.
- Jupyter Notebook¶
Jupyter Notebooks are documents that contain both computer code (e.g. Python) and rich text elements (text, equations, links, etc…). CoCalc’s Jupyter Notebooks are collaborative, record all changes, and can be shared – internally or externally – very easily.
- JupyterLab¶
JupyterLab is a web-based interactive development environment for Jupyter notebooks, code, and data.
- Kubectl¶
Kubectl is the Kubernetes command-line tool, which allows you to run commands against Kubernetes clusters. See Kubectl for more information.
- Kubectl Aliases¶
Kubectl Aliases is a collection of useful aliases for kubectl.
- Kubernetes¶
Kubernetes is an open-source system for automating deployment, scaling, and management of containerized applications. See Kubernetes for more information.
- Kubernetes Jobs¶
A Kubernetes Job creates one or more Pods and ensures that a specified number of them successfully terminate. HELM test will show you a summary of running these jobs.
- Kustomize¶
Kustomize is a tool that allows you to customize raw, template-free YAML files for multiple purposes, leaving the original YAML untouched and usable as is. It is capable of rendering HELM charts as well. See Kustomize for more information.
- Label¶
A Kubernetes node label is a key-value pair that is attached to a node. See Labels and Selectors for more information.
- Large Language Models¶
Large language models (LLMs) are sophisticated computer programs trained on massive amounts of text data. They can generate realistic text, translate languages, write different kinds of creative content, and answer your questions in an informative way.
- LaTeX Documents¶
LaTeX is a document preparation system for high-quality typesetting. It is most often used for medium-to-large technical or scientific documents but it can be used for almost any form of publishing.
- Leaky Abstraction¶
A Leaky Abstraction is a term used to describe a situation where the abstraction provided by a system is not complete, and the user of the system must be aware of the details of the underlying system in order to use – and debug – it effectively.
- Let’s Encrypt¶
Let’s Encrypt is a free, automated, and open certificate authority (CA), run for the public’s benefit. See Let’s Encrypt for more information.
- Linux¶
Linux is a family of open-source POSIX-compliant Unix-like operating systems based on the Linux kernel.
- LoadBalancer¶
A cluster service, that exposes an application running on a set of Pods as a network service. See LoadBalancer for more information.
- MetalLB¶
MetalLB is a LoadBalancer implementation for bare metal Kubernetes clusters, using standard routing protocols. See MetalLB for more information.
- Minikube¶
Minikube is a tool that makes it easy to run Kubernetes locally.
- Namespace¶
A Namespace is a way to divide cluster resources between multiple users (via resource quota).
- NetworkPolicy¶
A NetworkPolicy is a specification of how groups of pods are allowed to communicate with each other and other network endpoints.
- NFS¶
Network File System (NFS) is a distributed file system protocol that allows you to mount remote directories and access them as though they were local. See NFS for more information.
- NGINX Ingress Controller¶
An Ingress controller that uses NGINX as the load balancer. See NGINX Ingress Controller for more information.
- Node selector¶
A node selector is a way to tell Kubernetes to only schedule certain pods onto nodes with particular labels.
- Node.js¶
Node.js is an open-source, cross-platform, back-end JavaScript runtime environment that runs on the V8 engine and executes JavaScript code outside a web browser.
- OAuth2¶
OAuth2 is an open standard for access delegation, commonly used as a way for Internet users to grant websites or applications access to their information on other websites but without giving them the passwords.
- Ollama¶
Ollama is an open-source framework designed to make it easier to run large language models (LLMs) on your own computer. It simplifies the setup process, manages the necessary files, and optimizes the models to work well on your specific hardware.
- on-premises¶
On-premises software is software that is installed on a computer or server within a company’s network, rather than being hosted externally by a cloud computing provider.
- overcommit ratio¶
An overcommit ratio is the ratio of the total amount of resources that are available to the total amount of resources that are requested.
- Passport JS¶
Passport JS is an authentication middleware for Node.js, designed to simplify the process of implementing various authentication strategies. It supports a wide range of authentication mechanisms, such as OAuth, OpenID, and username/password, allowing developers to easily integrate authentication into their applications. For more information, see the official documentation at Passport JS.
- PersistentVolume¶
A Kubernetes PersistentVolume (PV) is a piece of storage in the cluster.
- PersistentVolumeClaim¶
A Kubernetes PersistentVolumeClaim (PVC) is a request for storage of a PersistentVolume.
- Pod¶
A Kubernetes Pod is a group of one or more containers, with shared storage/network, a specification for how to run the containers. A Pod’s contents are always co-located and co-scheduled.
- Pod Disruption Budget¶
A Pod Disruption Budget is an object that limits the number of pods of a replicated application that are down simultaneously from voluntary disruptions.
- POSIX¶
POSIX is a family of standards specified by the IEEE Computer Society for maintaining compatibility between operating systems. Linux is a POSIX-compliant operating system.
- PostgreSQL¶
PostgreSQL is a powerful, open source object-relational database system with over 30 years of active development that has earned it a strong reputation for reliability, feature robustness, and performance. See PostgreSQL for more information.
- PriorityClasses¶
A PriorityClass defines a mapping from a priority class name to the integer value of the priority.
- PV¶
- PVC¶
- Python¶
Python is an interpreted, high-level and general-purpose programming language.
- R¶
R is a programming language and free software environment for statistical computing and graphics supported by the R Foundation for Statistical Computing.
- ReadWriteMany¶
A Kubernetes access mode that allows a filesystem to be mounted as read-write by many nodes.
- SageMath¶
SageMath is an open-source mathematics software system that provides a comprehensive environment for various mathematical computations, including algebra, calculus, combinatorics, numerical mathematics, and more. It integrates many existing open-source packages into a common interface, allowing users to work with complex mathematical tasks intuitively.
Note
Do not confuse with SageMath, Inc.
- SageMath, Inc.¶
SageMath, Inc. is the company that develops and maintains CoCalc.
- SAML¶
SAML is an XML-based standard for exchanging authentication and authorization data between security domains. This allows you to tie accounts from your identity provider (e.g. Google Workspaces or Microsoft’s Azure Active Directory) to this instance of CoCalc.
- Secret¶
A Secret is an object stored in Kubernetes that contains a small amount of sensitive data such as a password, a token, or a key.
- Service¶
A Service is an abstraction which defines a logical set of Pods and a policy by which to access them.
- ServiceAccount¶
A ServiceAccount is an account that is used by a pod to access the Kubernetes API.
- Single Page Application¶
A Single Page Application is a web application or web site that fits on a single web page with the goal to provide a more fluid user experience similar to a desktop application. CoCalc‘s main user interface is an example of that, using a WebSocket connection to the server.
- Site Settings¶
In the CoCalc web-based application, administrators have an “Admin” tab. There, a panel “Site Settings” let’s them control the configuration of the server. However, these values are maybe controlled by my-values.yaml.
- SMTP server¶
An SMTP server is a computer program or an email server that accepts and forwards email messages to other email servers.
- Snapshot¶
A snapshot of a filesystem is essentially a frozen “picture” of a volume’s data taken at a point in time.
- Sourcing a Bash Script¶
Sourcing a Bash script allows you to execute the commands in the script in the current shell environment, which means that any variables or functions defined in the script will be available after the script finishes executing.
- Sourcing a Script¶
“sourcing a script” in Bash means to execute the commands in the script in the current shell environment instead of creating a new shell environment for the script. The syntax is
source <script>
or. <script>
.- Sqlite3¶
Sqlite3 is a relational database management system contained in a C library. In contrast to other database management systems, it is not a separate process that is accessed from the client application, but an integral part of it.
- SSHFS¶
SSHFS is a filesystem client based on the SSH File Transfer Protocol. It allows you to mount a remote filesystem using SFTP and interact with it as though it were a local filesystem.
- SSO¶
Single Sign-On (SSO) is an authentication process that allows a user to access multiple applications with one set of login credentials (such as username and password). This streamlines the user experience by reducing the number of times a user must log in and enhances security by minimizing the number of passwords that must be managed. See Single Sign-On for more information.
- StorageClass¶
A Kubernetes Storage Class is a way to specify, how a request for a persistent volume is handled, i.e. which kind of storage backend is used.
- Taint¶
A Kubernetes node taint is a property that you apply to a node. A taint is a key-value pair that you can use to define a node’s special characteristics. See Taints and Tolerations for more information.
- TimeTravel¶
TimeTravel in CoCalc is a feature that allows you to go back in time to a previous version of a file or directory. It’s similar to the Time Machine feature in MacOS.
- UID¶
User Identifier: a unique numerical value assigned to each user account. It serves as the primary means of identifying users and determining their permissions and access levels to system resources. The root user has UID 0, while other users are assigned progressively higher UIDs. See also GID and UID/GID.
- UID/GID¶
A POSIX filesystem has two types of identifiers for files and directories: the user ID (UID) and the group ID (GID). See also UID and GID.
- UUID¶
A universally unique identifier (UUID) is a 128-bit number used to identify information in computer systems. See UUID for more information.
- VPN¶
A VPN is a private network that extends across a public network, such as the Internet.
- VSCode¶
VSCode is a free source-code editor made by Microsoft for Windows, Linux and macOS.
- WebSocket¶
A WebSocket is a computer communications protocol, providing full-duplex communication channels over a single TCP connection. It’s commonly used for Single Page Applications.
- YAML¶
YAML is a human-readable data-serialization language. It is commonly used for configuration files and in applications where data is being stored or transmitted.
- YMMV¶
Your mileage may vary.