Deckhouse Platform in existing cluster

1
Selecting infrastructure
2
A brief overview of installation
3
Setting up cluster
4
Installation
5
Getting access to the cluster
6
What can I do next?

Congratulations, your Deckhouse platform is up and running!

Now that you have installed and properly configured Deckhouse, let’s look at what you can do with it.

By default, the Dex is used for accessing all the components.

Here are credentials generated in the previous steps:

  • Username — admin@example.com
  • Password — <GENERATED_PASSWORD>

Use them to access the web interface of the Deckhouse components.

Essentials

Up-to-date Deckhouse documentation in your cluster

The in-cluster documentation for a specific version of Deckhouse used in your cluster is available at deckhouse.example.com.

Monitoring

Explore Grafana dashboards bundled with Deckhouse at grafana.example.com.

Go to grafana.example.com/prometheus/ to access Prometheus directly.

Learn more about the monitoring module.

Dashboard

The Kubernetes Dashboard is available at: dashboard.example.com

Status page

Visit status.example.com to get information about the overall status of Deckhouse and its components.

The upmeter.example.com page provides detailed SLA statistics for each component and time frame.

Deploying your first application

Setting up a CI/CD system

Create a ServiceAccount to use for deploying to the cluster and grant it all the necessary privileges.

You can use the generated kubeconfig file in Kubernetes with any deployment system.

Routing traffic

Create a Service and Ingress for your application.

Learn more about the capabilities of the ingress-nginx module.

Monitoring your application

Add prometheus.deckhouse.io/custom-target: "my-app" and prometheus.deckhouse.io/port: "80" annotations to the Service created.

For more information, see the monitoring-custom module’s documentation.

External authentication

Deckhouse supports various external authentication mechanisms.

Configuring DexProvider

You have to configure a DexProvider object to enable, e.g., GitHub-based authentication. After creating the DexProvider object, all access attempts to Deckhouse components such as Grafana, Dashboard, etc., will be authenticated using GitHub.

External authentication for any Ingress

You have to create a DexAuthenticator object to enable external authentication for any Ingress resource.

External authentication for the Kubernetes API

Configure publishAPI, download kubectl and create a kubeconfig file for external access to the API using the web interface available at kubeconfig.example.com.

What’s next?

Detailed information about the system and the Deckhouse Platform components is available in the documentation.

Please, reach us via our online community if you have any questions.

Go back