Skyscrapers products & services documentation

This repository contains user-level technical documentation for our product & service offering, documentation on tools and best practices as well as the way we do our work (processes). The main target audience are the Skyscrapers customers.

Technical Documentation

In this knowledge base you'll find information on how to use your Kubernetes cluster, how to create a Concourse pipeline, how to manage containerized applications and how to monitor them, etc. You'll also find some opinionated good practices, tips and recommendations, along with references to external sources of documentation and articles. It's intended to be browsed mainly through GitHub or a local git clone, so the file tree acts as the table of contents.

Each header points to the main README of each platform offering. Within each folder you'll also find documentation on more advanced and/or specific topics.

• AWS
  • ECR
  • IAM Delegated Access
  • RDS
• Backups
• Coding Guidelines and Best Practices - Main coding guidelines we adhere to at Skyscrapers
  • Concourse
  • Docker
  • Documents
  • Git
  • Helm
  • Terragrunt / OpenTofu
• Concourse - Walk-through on how to use Concourse and setup pipelines
  • Feature Environments
• Kubernetes - Walk-through on getting access to and deploying applications on our K8s clusters
  • Getting started
  • AWS Secrets Manager
  • Backups
  • Dynamic, whitelabel-style Ingress to your application
  • Flux
  • GitHub actions runners
  • Helm
  • Jaeger
  • Karpenter
  • Logs
  • Monitoring
  • Network Policies
  • OpenVPN
  • Persistent Volumes
  • Pods
  • Role Based Access Control (RBAC)
  • Service Mesh
  • UDP
  • Vault
• MongoDB Atlas
• Runbook - Description of our custom monitoring alerts with possible remediations

Onboarding

Here you will find the resources related to the onboarding track for our new customers.

• Onboarding
  • Kubernetes Platform Orientation - Kubernetes Platform Orientation workshop material

Process and services

This is where you can find information on certain aspects of the DOaaS that we offer (.e.g. the way we offer our every day support to you).

• DevOps-as-a-Service: Platform Users and User Roles
• Skyscrapers Support Process
• Skyscrapers Security Policy

Contributing

Your contributions are very welcomed, so if you have any suggestions to improve this documentation feel free to open an issue or a pull request. In any case, it's important that you keep in mind the following guidelines:

• All documentation in this repo is written in Markdown and must be compliant with GitHub Flavoured Markdown (GFM)
• File and folder names should be descriptive enough to let the reader know what's in them
• Make sure to update the main ToC above