An unofficial series of tools that enable various debugging utilities for Red Hat OpenShift Container Platform 4.
Please note nothing in this repository is connected to or supported by Red Hat in any way.
If you are experiencing issues with your Red Hat OpenShift Container Platform 4 cluster and have a valid support subscription, it is ALWAYS best to first reach out to Red Hat Support directly.
Running any external software on your Red Hat products runs the risk of downtime in production, data loss, or security breach, including what is found within this repository.
No responsibility is taken by any of the parties involved with this repository for issues arising with your business or systems as a result of utilizing anything or taking the advice of anything in this repository.
USE AT YOUR OWN RISK.
Provided in this repository is a collection of scripts and YAML files which you can deploy to your Red Hat OpenShift Container Platform 4 cluster in attempts to enable deeper debugging, logging, or a feature that perhaps does not currently exist in a current Red Hat offering at this time.
The repository is divded into two sections; setting up the debugging project and required components, and then utilizing various utilities within this repository to enable the desired functionality. It is expected that you will first set up the openshift4-debug
project and environment prior to running any available utilities, as utilities are authored expecting to be placed into the openshift4-debug
project. Below, you will find instructions on setting up the initial project.
Ensure you are logged into your Red Hat OpenShift Container Platform 4 cluster as a user with expansive admin privileges, such as system:admin
with the oc OpenShift command line utility.
$ oc create -f openshift4-debug.yaml
namespace/openshift4-debug created
serviceaccount/openshift4-debug created
securitycontextconstraints.security.openshift.io/openshift4-debug created
This creates a number of items within your cluster, notably a namespace, a service account, a security context constraint, and an image stream. The namespace should encompass all entities from the openshift4-debug
repository including users, images, and utilities deployed. The service account and security context restraint are a carte blanche access to the cluster by this user, including the node's root filesystems. Some utilities that monitor node performance require this.
It is a major security concern to have an account running pods with as much access as the security context in this repository provides, and this can cause downtime, corruption of data, or unintended access to the cluster. Please be careful and use at your own risk.
From there, read on how to apply utilities to your openshift4-debug
project within your cluster.
Utilities may vary greatly in behavior and setup, and instructions for configuration are provided by the respective utility. Select a utility below to learn more and see how to deploy it to your openshift4-debug
project on your cluster.
A robust perl application that collects ongoing performance data from various subsystems for playback and analysis.
The tcpdump utility allows you to perform automated packet captures directly on nodes.
When openshift4-debug
has outlived it's usefulness, remove it entirely from the cluster like so:
# Remove all running utilities
$ oc -n openshift4-debug delete all -l=app=openshift4-debug
# Delete initial resources
$ oc delete -f openshift4-debug.yaml
Contributions are welcome and those who chose to contribute are thanked immensely.
Please follow the instructions in our Contributions Guide to get started.
Apache V2 License Copyright [2021] [Robb Manes]
Licensed under the apache license, version 2.0 (the "license"); You may not use this file except in compliance with the license. You may obtain a copy of the license at
http://www.apache.org/licenses/license-2.0
Unless required by applicable law or agreed to in writing, software distributed under the license is distributed on an "as is" basis, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
See the license for the specific language governing permissions and limitations under the license.
The full Apache V2 License is available within this repository in the [LICENSE.md][LICENSE.md] file.
openshift4-debug's People
Forkers
novonilc eljabsheh rupesh-git-eng ahmedelkoush vwalek acostamanowarrior rgouveia-redhat rjhowe alfredopizarroRecommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. ๐๐๐
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google โค๏ธ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.