Skip to content
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

Created new term "Sidecar Container" #3353

Open
wants to merge 3 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
38 changes: 38 additions & 0 deletions content/en/sidecar-container.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
title: Sidecar Container
status: Feedback Appreciated
category: concept
---

The Sidecar Container is an implementation of the sidecar pattern.
An application deployed on a second container will run side by side
and share its lifecycle with a primary application running on a main container.

## Problem it addresses

There are scenarios where it is convenient to group [containers](/container/)
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
There are scenarios where it is convenient to group [containers](/container/)
There are scenarios where it is convenient to group [containers](/container/) and their lifecycle

to deal with cross-platform requirements or shared functionality.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
to deal with cross-platform requirements or shared functionality.
to deal with scenarios

Such scenarios include [observability](/observability/) topics
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Such scenarios include [observability](/observability/) topics

like logging, monitoring, tracing, but also security, and networking.
For example, when multiple microservices have their sidecar containers
Copy link
Collaborator

Choose a reason for hiding this comment

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

Here we talk already about the solution. This would be where you should show how collecting logs would look without the sidecar container.

acting as logging agents to collect and forward logs to a log server,
or collecting metrics to forward to a monitoring system.

## How it helps

The term "sidecar" comes from the representation of a classic motorcycle
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
The term "sidecar" comes from the representation of a classic motorcycle

with its attached sidecar.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
with its attached sidecar.

In this metaphor, the bike represents the main container
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
In this metaphor, the bike represents the main container

and the sidecar the secondary container.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
and the sidecar the secondary container.

This approach consists of using a separated process
running on a secondary container to address problems
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
running on a secondary container to address problems
running on a secondary container.

that aren't unique to a single application
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
that aren't unique to a single application

but rather to the entire platform where the application is running.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
but rather to the entire platform where the application is running.

We already kinda said that the problems are not unique to an application, but rather cross-platform relevant

The Sidecar Container will share the same resources,
including storage and networking, as the main container.
While doing this, it frees the main container to be focused on functional tasks
Copy link
Collaborator

Choose a reason for hiding this comment

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

This sentence is a bit vague. I would rather be happy to see a more specific example. For instance something like this:

This makes it easy for a logging sidecar to collect logs from the main application without needing to change anything in the main application. The sidecar could read the same directory, the main application writes its logs to.

or exposing business capabilities.
As a secondary container, the "sidecar" takes care of platform related tasks
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
As a secondary container, the "sidecar" takes care of platform related tasks

redundant

such as logging, monitoring or security.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
such as logging, monitoring or security.

It enforces the principle of separation of concerns
Copy link
Collaborator

Choose a reason for hiding this comment

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

if you accept my suggested change some comments above this sentence could become redundant.

and provides extending functionality without changing the main application's code.