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

Proposal for fleet management overview page #2185

Draft
wants to merge 8 commits into
base: main
Choose a base branch
from

Conversation

pipo02mix
Copy link
Contributor

What this PR does / why we need it

Towards https://github.com/giantswarm/giantswarm/issues/30179

Things to check/remember before submitting

  • If you made content changes

    • Run make dev to render and proofread content changes locally.
    • Bump last_review_date in the front matter header if you reviewed the entire page.

@pipo02mix pipo02mix requested a review from a team as a code owner April 19, 2024 08:59
@pipo02mix pipo02mix self-assigned this Apr 19, 2024
src/content/overview/fleet management/_index.md Outdated Show resolved Hide resolved
src/content/overview/fleet management/_index.md Outdated Show resolved Hide resolved
src/content/overview/fleet management/_index.md Outdated Show resolved Hide resolved
src/content/overview/fleet management/_index.md Outdated Show resolved Hide resolved
- **Multi-environment**: We support multiple providers, regions and environments. Platform engineers can map their company structure to our platform structure in order to ease the management of their teams and workloads.
- **Configuration management**: We rely on GitOps principles to manage the configuration of your clusters, environments and workloads having multiple layers of configuration.
- **Cluster lifecycle management**: We provide a way to manage the lifecycle of your clusters, from creation to deletion, including upgrades and scaling.
- **Workload management**: We have developed a solution to help your developers to configure and deploy their applications in a cloud-native way.
Copy link
Contributor

Choose a reason for hiding this comment

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

Too vague. What do we describe here? Is it the app platform? If yes, does "workload management" really cut it as a good term?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

yeah I asked Puja for help to define those better, I came up with some ideas but ideally we describe those better :)

src/content/overview/fleet management/_index.md Outdated Show resolved Hide resolved
Co-authored-by: Andreas Sommer <andreas@giantswarm.io>
@pipo02mix pipo02mix marked this pull request as draft May 3, 2024 09:47

Based on our extensive experience, we understand that orchestrating a large-scale microservices platform poses significant challenges. Ideally, workloads should be designed for seamless execution in the cloud, tailor-made to optimize the container lifecycle. However, the task becomes exponentially more complex when juggling multiple providers, regions, and environments. Recognizing this, we've developed several abstraction layers to help streamline management and tackle this complexity more effectively.

## Features
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
## Features
## Capabilities

owner:
- https://github.com/orgs/giantswarm/teams/sig-product
---

Based on our extensive experience, we understand that orchestrating a large-scale microservices platform poses significant challenges. Ideally, workloads should be designed for seamless execution in the cloud, tailor-made to optimize the container lifecycle. However, the task becomes exponentially more complex when juggling multiple providers, regions, and environments. Recognizing this, we've developed several abstraction layers to help streamline management and tackle this complexity more effectively.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
Based on our extensive experience, we understand that orchestrating a large-scale microservices platform poses significant challenges. Ideally, workloads should be designed for seamless execution in the cloud, tailor-made to optimize the container lifecycle. However, the task becomes exponentially more complex when juggling multiple providers, regions, and environments. Recognizing this, we've developed several abstraction layers to help streamline management and tackle this complexity more effectively.
Based on our extensive experience, we understand that orchestrating a large-scale microservices platform poses significant challenges. Ideally, workloads should be designed for seamless execution in the cloud, tailor-made to optimize the container lifecycle. However, the task becomes exponentially more complex when juggling multiple providers, regions, clusters, and environments. Recognizing this, we've developed several abstraction layers to help streamline management and tackle this complexity more effectively.

owner:
- https://github.com/orgs/giantswarm/teams/sig-product
---

Based on our extensive experience, we understand that orchestrating a large-scale microservices platform poses significant challenges. Ideally, workloads should be designed for seamless execution in the cloud, tailor-made to optimize the container lifecycle. However, the task becomes exponentially more complex when juggling multiple providers, regions, and environments. Recognizing this, we've developed several abstraction layers to help streamline management and tackle this complexity more effectively.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Based on our extensive experience, we understand that orchestrating a large-scale microservices platform poses significant challenges. Ideally, workloads should be designed for seamless execution in the cloud, tailor-made to optimize the container lifecycle. However, the task becomes exponentially more complex when juggling multiple providers, regions, and environments. Recognizing this, we've developed several abstraction layers to help streamline management and tackle this complexity more effectively.
Based on our extensive experience, we understand that orchestrating a large-scale microservices platform poses significant challenges. Ideally, workloads should be designed for seamless execution in the cloud and in containers. However, this becomes exponentially more complex when juggling multiple providers, regions, clusters and environments. Recognizing this, we've developed abstractions to help manage and tackle this complexity effectively.

Removed some fill words and things that are kind of mentioned multiple times and made the sentence too long.


Our product is designed to offer a comprehensive set of features to support the construction of robust Cloud Native Platforms. Key features include:

- **Multi-Environment Support**: Every enterprise has unique requirements and constraints, influencing how they design their developer platforms. Platform engineers often struggle to align their organization's structure and processes with the platform while maintaining the system's ability to foster speed and quality, all in compliance with company standards. Our solution, Giant Swarm, simplifies this process. It empowers you to provide developers with various environments, across different regions and providers, tailored to your organization's needs.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- **Multi-Environment Support**: Every enterprise has unique requirements and constraints, influencing how they design their developer platforms. Platform engineers often struggle to align their organization's structure and processes with the platform while maintaining the system's ability to foster speed and quality, all in compliance with company standards. Our solution, Giant Swarm, simplifies this process. It empowers you to provide developers with various environments, across different regions and providers, tailored to your organization's needs.
- **Multi-Environment Support**: Every enterprise has unique requirements and constraints, influencing how they design their developer platforms. Platform engineers often struggle to align their organization's structure and processes with the platform while maintaining the system's ability to foster speed and quality, all in compliance with company standards. Our solution, the Giant Swarm platform, simplifies this process. It empowers you to provide developers with various environments, across different regions and providers, flexibly adapted to your organization's needs.

Not sure about "flexibly adapted" – I wanted to add the word "flexible" in some way, to ensure that customers understand that the platform is adaptable, not tailored/hardcoded by Giant Swarm to their environments.


- **Multi-Environment Support**: Every enterprise has unique requirements and constraints, influencing how they design their developer platforms. Platform engineers often struggle to align their organization's structure and processes with the platform while maintaining the system's ability to foster speed and quality, all in compliance with company standards. Our solution, Giant Swarm, simplifies this process. It empowers you to provide developers with various environments, across different regions and providers, tailored to your organization's needs.

- **Robust Configuration Management**: Manage your clusters, environments, and workloads with flexibility and precision using our robust configuration management framework. This framework facilitates structured platform configuration with multiple layers of control, all from a single repository. It's crafted to adhere to the principles of GitOps, ensuring seamless and efficient management.
Copy link
Contributor

Choose a reason for hiding this comment

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

We didn't use the term "framework" before. Can we leave that word out or use a term we already have?


- **Robust Configuration Management**: Manage your clusters, environments, and workloads with flexibility and precision using our robust configuration management framework. This framework facilitates structured platform configuration with multiple layers of control, all from a single repository. It's crafted to adhere to the principles of GitOps, ensuring seamless and efficient management.

- **Standardized Cluster Lifecycle Management**: Experience a standardized approach to managing the lifecycle of your clusters. Developed in collaboration with the community, Giant Swarm offers a cloud-native solution for cluster lifecycle management. We leverage the Cluster API implementation to streamline lifecycle management, enabling versioning and configuration of clusters as code, thus ensuring consistency and reliability.
Copy link
Contributor

Choose a reason for hiding this comment

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

Better remove title case in this whole bullet point list, since those are not proper nouns/terms.


- **Robust Configuration Management**: Manage your clusters, environments, and workloads with flexibility and precision using our robust configuration management framework. This framework facilitates structured platform configuration with multiple layers of control, all from a single repository. It's crafted to adhere to the principles of GitOps, ensuring seamless and efficient management.

- **Standardized Cluster Lifecycle Management**: Experience a standardized approach to managing the lifecycle of your clusters. Developed in collaboration with the community, Giant Swarm offers a cloud-native solution for cluster lifecycle management. We leverage the Cluster API implementation to streamline lifecycle management, enabling versioning and configuration of clusters as code, thus ensuring consistency and reliability.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- **Standardized Cluster Lifecycle Management**: Experience a standardized approach to managing the lifecycle of your clusters. Developed in collaboration with the community, Giant Swarm offers a cloud-native solution for cluster lifecycle management. We leverage the Cluster API implementation to streamline lifecycle management, enabling versioning and configuration of clusters as code, thus ensuring consistency and reliability.
- **Standardized cluster lifecycle management**: Experience a standardized approach to managing the lifecycle of your clusters. Giant Swarm leverages the Cluster API implementation, a Kubernetes subproject developed by the open source community, including Giant Swarm engineers as regular contributors. It allows for consistent and reliable cluster lifecycle management, enabling versioning and configuration of clusters as code.


## Cloud-native applications

The platform is heavily relying on [Cluster API implementation]({{< relref "/overview/fleet-management/introduction_cluster-api" >}}) to manage the lifecycle of your clusters. It opens up the possibility to manage your clusters in many providers adapting to the infrastructure nuances of each solution while keeping a consistent experience for the user.
Copy link
Contributor

Choose a reason for hiding this comment

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

We already have basically this sentence above, and this sentence doesn't say anything more (apart from linking to other docs). I'd expect very few links in the overview in order to take the audience through the writeup top-down without jumping. Should we have a rough Cluster API explanation on this page instead, or leave off the link?


The platform is heavily relying on [Cluster API implementation]({{< relref "/overview/fleet-management/introduction_cluster-api" >}}) to manage the lifecycle of your clusters. It opens up the possibility to manage your clusters in many providers adapting to the infrastructure nuances of each solution while keeping a consistent experience for the user.

Every company requires a different level of control over their infrastructure and its configuration. We work with upstream to offer you a platform that is compliant with all the standards and processes your company imposes.
Copy link
Contributor

Choose a reason for hiding this comment

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

We need to make explicit points in here. This is too vague and not saying more than the bullet list above.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants