Skip to content

Commit

Permalink
Improve admin landing page
Browse files Browse the repository at this point in the history
  • Loading branch information
cristiklein committed Sep 14, 2023
1 parent 110be8e commit 09ed361
Show file tree
Hide file tree
Showing 4 changed files with 87 additions and 10 deletions.
2 changes: 1 addition & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ Elastisys Compliant Kubernetes enables organizations across Europe to accelerate
:fontawesome-solid-laptop-code:
Consulting
</dt>
<dd>
<dd class="grow-me">
Extend your team with our cloud native experts. Develop and deploy apps faster and with more confidence in a DevSecOps fashion.
</dd>
<dd>
Expand Down
73 changes: 66 additions & 7 deletions docs/operator-manual/index.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,70 @@
---
hide:
- toc
---
# Platform Administrator Manual Overview

This manual is for Compliant Kubernetes administrators.
<div class="landing-page" markdown="1">

Platform Administrator can be described via the following user stories:
Compliant Kubernetes abstracts away a lot of complexity from Application Developers.
Unfortunately, someone somewhere needs to take care of that complexity.
That person is you, the platform administrator.

* As a Platform Administrator I want to create/destroy/upgrade a Compliant Kubernetes cluster.
* As a Platform Administrator I want to re-configure a Compliant Kubernetes cluster.
* As an on-call Platform Administrator I want to be alerted when abnormal activity is detected, suggesting a pending intrusion.
* As an on-call Platform Administrator I want to be alerted when the Compliant Kubernetes cluster is unhealthy.
* As an on-call Platform Administrator I want "break glass" to investigate and recover an unhealthy Compliant Kubernetes cluster.
Setting up Compliant Kubernetes is not for the faint hearted.
We recommend you to proceed in 4 steps as shown below:

<nav markdown="1">
<dl class="columns-2" markdown="1">
<div markdown="span">
<dt markdown="span">
:fontawesome-solid-laptop-code:
Phase 1: Try out the end result
</dt>
<dd>
Validate that the application team's needs will be satisfied.
Start with Compliant Kubernetes managed by an experienced platform team on a trusted EU cloud infrastructure.
</dd>
<dd>
<a role="button" href="https://elastisys.com/managed-services/">Learn more</a>
</dd>
</div>
<div markdown="span">
<dt markdown="span">
:fontawesome-solid-magnifying-glass:
Phase 2: Infrastructure audit
</dt>
<dd class="grow-me">
Clarify the capabilities of your infrastructure and ways of working with your infrastructure team.
</dd>
<dd>
<a role="button" href="./provider-audit/">Learn more</a>
</dd>
</div>
<div markdown="span">
<dt markdown="span">
:fontawesome-solid-gears:
Phase 3: Compliant Kubernetes setup
</dt>
<dd class="grow-me">
Now that the infrastructure is in place, you're ready to configure and install Compliant Kubernetes.
</dd>
<dd>
<a role="button" href="./on-prem-standard/">Learn more</a>
</dd>
</div>
<div markdown="span">
<dt markdown="span">
:fontawesome-solid-user-graduate:
Phase 4: Deepen your knowledge and operate
</dt>
<dd class="grow-me" markdown="span">
Practice [maintenance](maintenance.md), [capacity management](capacity-management.md) and [troubleshooting](troubleshooting.md).
</dd>
<dd>
<a role="button" href="https://elastisys.com/free-guide-how-to-operate-a-secure-kubernetes-platform/">Learn more</a>
</dd>
</div>
</dl>
</nav>

</div>
2 changes: 2 additions & 0 deletions docs/operator-manual/on-prem-standard.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,8 @@ This document contains instructions on how to set-up a new Compliant Kubernetes
- Identity Provider (IdP) choice and configuration. See [this page](../user-guide/prepare-idp.md).
- On-call Management Tool (OMT) choice and configuration

1. Make sure you [install all prerequisites](getting-started.md) on your laptop.

1. Prepare Ubuntu-based VMs:
If you are using public clouds, you can create VMs using the scripts included in Kubespray:
- For Azure, use [AzureRM scripts](https://github.com/kubernetes-sigs/kubespray/tree/master/contrib/azurerm).
Expand Down
20 changes: 18 additions & 2 deletions extra_sass/style.css.scss
Original file line number Diff line number Diff line change
@@ -1,8 +1,25 @@
/* Stuff on the landing page needs to be more specific than mkdocs-material's CSS. */
.md-content .landing-page {
.columns {
display: flex;
flex-flow: row;

div {
width: 100%;
}
}

.columns-2 {
flex-flow: row wrap;

div {
flex-grow: 1;
width: 40%;
}
}

.columns,
.columns-2 {
display: flex;
margin: 0;
padding: 0;
gap: 10px;
Expand All @@ -12,7 +29,6 @@
}

div {
width: 100%;
border: 5px solid var(--esys-blue-04);
text-align: center;
padding: 12px 24px;
Expand Down

0 comments on commit 09ed361

Please sign in to comment.