Merge pull request #156 from anveshmuppeda/feature/docs_update

Adding new guides: node viewer and kubecost

Author: anveshmuppeda

docs/eks-guides/006-eks-auto-mode.md

@@ -1,7 +1,7 @@
 ---
 // filepath: /Users/anveshmuppeda/Desktop/anvesh/tech/git/kubernetes/docs/eks/006-eks-auto-mode.md
 sidebar_label: "EKS Auto Mode"
-sidebar_position: 5
+sidebar_position: 6
 ---  
 # Amazon EKS Auto Mode: A Hands-On Guide
 #### *Automate compute, networking, and storage in your Kubernetes clusters with step-by-step instructions.*

docs/eks-guides/007-kubecost.md

@@ -0,0 +1,138 @@
+---
+// filepath: /Users/anveshmuppeda/Desktop/anvesh/tech/git/kubernetes/docs/eks/007-kubecost.md
+sidebar_label: "Kubecost"
+sidebar_position: 7
+---  
+
+# Amazon EKS Kubecost: A Hands-On Guide
+#### *Monitor and optimize your Kubernetes costs with step-by-step instructions.*
+
+Here’s a concise guide covering what Kubecost is, why you’d use it, and exactly how to install, access, and uninstall it on Amazon EKS (without mentioning specific version numbers).
+
+![Kubecost](./img/kubecost.gif)
+
+### **Summary**  
+[Kubecost](https://github.com/kubecost) is an open‑core tool that provides real‑time visibility into your Kubernetes spending—breaking down costs by cluster, namespace, pod, node, and label—to help teams allocate, optimize, and continuously reduce cloud costs. You can deploy it on Amazon EKS either as an AWS‑managed add‑on or via Helm, then port‑forward or expose its dashboard to visualize and manage your spend. When you’re done, you can remove it cleanly with a single CLI command or Helm uninstall sequence.
+
+## What is Kubecost and Why Use It
+
+Kubecost provides real‑time cost visibility and insights for teams running Kubernetes, helping you continuously reduce your cloud spend by surfacing where costs occur and suggesting optimizations.
+It breaks down your bill by cluster, namespace, pod, node, persistent volume, and custom labels—enabling charge‑back, show‑back, and right‑sizing across teams or projects.
+
+## Installing Kubecost
+
+### 1. As an Amazon EKS Add‑on
+
+**Prerequisites**
+
+* Subscribe to “[Kubecost – Amazon EKS cost monitoring](https://aws.amazon.com/marketplace/seller-profile?id=983de668-2731-4c99-a7e2-74f27d796173)” in the AWS Marketplace.
+* Have `kubectl`, the AWS CLI, and access to your EKS cluster. 
+
+**Install using AWS CLI**
+
+```bash
+aws eks create-addon \
+  --addon-name kubecost_kubecost \
+  --cluster-name YOUR_CLUSTER_NAME \
+  --region YOUR_REGION
+```
+![Kubecost EKS Add-on](./img/kubecost-addon.png)
+
+**Install using CFT**
+
+Use the [AWS CloudFormation template - Kubecost](./cloudformation/eks-kubecost.yaml) to deploy the 
+IBM Kubecost - Amazon EKS cost monitoring add‑on. 
+
+
+This deploys the AWS‑optimized Kubecost bundle, complete with built‑in Prometheus and kube‑state‑metrics.
+
+### 2. With Helm
+
+**Prerequisites**
+
+* Install `kubectl`, Helm 3+, and access to your EKS cluster (plus the Amazon EBS CSI driver). 
+
+**Install**
+
+1. Add the Kubecost Helm repo
+
+   ```bash
+   helm repo add kubecost https://kubecost.github.io/cost-analyzer/
+   helm repo update
+   ```
+2. Install the Kubecost Helm chart
+
+   ```bash
+   helm install kubecost kubecost/cost-analyzer -n kubecost --create-namespace \
+    --set kubecostToken="aGVsbUBrdWJlY29zdC5jb20=xm343yadf98"
+   ```
+   kubecostToken, it is generated at http://kubecost.com/install, used for alerts tracking and free trials. 
+   Or you can use the following command to install the latest version of Kubecost:
+
+    ```bash
+    helm upgrade -i kubecost \
+        oci://public.ecr.aws/kubecost/cost-analyzer \
+        --namespace kubecost --create-namespace \
+        -f https://raw.githubusercontent.com/kubecost/cost-analyzer-helm-chart/develop/cost-analyzer/values-eks-cost-monitoring.yaml
+    ```
+
+This drops in Kubecost along with its required dependencies; you can further customize via additional Helm values.
+
+## Using Kubecost
+
+1. **Verify pods are running**
+
+   ```bash
+   > kubectl get pods -n kubecost
+    NAME                                         READY   STATUS    RESTARTS   AGE
+    kubecost-cost-analyzer-ff44d778f-lsgrh       4/4     Running   0          5m16s
+    kubecost-forecasting-56475fdf55-jwb26        1/1     Running   0          5m16s
+    kubecost-prometheus-server-bb875b789-zd6d9   1/1     Running   0          5m16s
+   ```
+2. **Expose the dashboard**
+
+   ```bash
+   > kubectl port-forward --namespace kubecost deployment/kubecost-cost-analyzer 9090
+    Forwarding from 127.0.0.1:9090 -> 9090
+    Forwarding from [::1]:9090 -> 9090
+    Handling connection for 9090
+    Handling connection for 9090 
+   ```
+3. **Browse the UI**
+   Open [http://localhost:9090](http://localhost:9090) in your browser to view cost allocations, asset spend, and efficiency insights .
+
+## Uninstalling Kubecost
+
+### Remove the EKS Add‑On
+
+```bash
+aws eks delete-addon \
+  --addon-name kubecost_kubecost \
+  --cluster-name YOUR_CLUSTER_NAME \
+  --region YOUR_REGION
+``` 
+
+### Remove the CloudFormation Stack
+
+```bash
+aws cloudformation delete-stack \
+  --stack-name YOUR_STACK_NAME
+```
+This removes the Kubecost add‑on and all associated resources.
+
+### Uninstall the Helm Release  
+```bash
+helm uninstall kubecost --namespace kubecost
+kubectl delete namespace kubecost
+```
+
+---
+
+With this guide, you can quickly set up Kubecost for cost visibility in your EKS clusters, explore your spending through a live dashboard, and remove it cleanly when it’s no longer needed.  
+
+---
+## Additional Resources
+* [Kubecost Documentation](https://docs.kubecost.com/)
+* [Kubecost GitHub](https://github.com/kubecost)
+* [Kubecost on AWS Marketplace](https://aws.amazon.com/marketplace/seller-profile?id=983de668-2731-4c99-a7e2-74f27d796173)
+* [Kubecost on AWS Blog](https://docs.aws.amazon.com/eks/latest/userguide/cost-monitoring-kubecost.html)

docs/eks-guides/008-eks-node-viewer.md

@@ -0,0 +1,162 @@
+---
+// filepath: /Users/anveshmuppeda/Desktop/anvesh/tech/git/kubernetes/docs/eks/008-eks-node-viewer.md
+sidebar_label: "EKS Node Viewer"
+sidebar_position: 8
+---  
+
+# EKS Node Viewer: A Hands-On Guide
+#### *Visualize and optimize your EKS node usage with this open-source CLI tool.*
+
+![EKS Node Viewer](./img/eks-node-viewer.gif)
+
+## Summary
+EKS Node Viewer is an open‑source CLI tool for visualizing scheduled pod resource requests against a node’s allocatable capacity in Amazon EKS clusters, originally built at AWS to showcase workload consolidation with Karpenter. It helps identify under‑ and over‑utilized nodes, driving cost and performance optimization. Installation is straightforward via Homebrew or a Go install, and its rich flag set lets you tailor context, resource types, labels, sorting, and even on‑the‑fly pricing lookups. Key use‑cases include rightsizing clusters, validating consolidation strategies, and enhancing SRE visibility into node utilization.
+
+---
+
+## Introduction
+
+EKS Node Viewer is a CLI tool for visualizing dynamic node usage within a Kubernetes cluster by comparing scheduled pod resource requests to each node’s allocatable capacity, without measuring actual consumption .
+It was originally developed as an internal AWS tool to demonstrate consolidation capabilities in Karpenter before being open‑sourced .
+
+---
+
+## Why Use EKS Node Viewer
+
+1. **Immediate Utilization Insights**
+   Quickly spot nodes that are under‑utilized (wasting resources) or over‑utilized (risking performance issues) by viewing request vs. capacity .
+
+2. **Optimize Cost and Performance**
+   By identifying consolidation opportunities, you can safely reduce node counts or reclaim unused capacity, complementing Karpenter’s autoscaling and spot instance workflows.
+
+3. **Enhanced SRE Visibility**
+   Provides a clear, real‑time overview of cluster footprint, aiding incident response and capacity planning.
+
+---
+
+## What It Is & Key Use Cases
+
+* **Visualization of Scheduled Requests**: Shows CPU, memory (and optionally other resources) requests on each node versus what’s allocatable .
+* **Consolidation Validation**: Confirm that Karpenter’s consolidation logic places pods optimally and safely drains nodes when needed.
+* **Cost Auditing**: With optional pricing lookups, estimate the cost impact of node usage in real‑time (can be disabled if AWS credentials aren’t available) .
+
+---
+
+## Installation
+
+### Homebrew
+
+```bash
+brew tap aws/tap
+brew install eks-node-viewer
+```
+
+This installs the latest stable version via the AWS Homebrew tap .
+
+### Manual (Go)
+
+```bash
+go install github.com/awslabs/eks-node-viewer/cmd/eks-node-viewer@latest
+```
+
+By default this places the binary in your `GOBIN` (e.g., `~/go/bin`) .
+
+---
+
+## Usage
+
+Run without arguments to inspect all nodes in your current context:
+
+```bash
+eks-node-viewer
+```
+
+### Key Flags
+
+```bash
+Usage of ./eks-node-viewer:
+  -attribution
+    	Show the Open Source Attribution
+  -context string
+    	Name of the kubernetes context to use
+  -disable-pricing
+    	Disable pricing lookups
+  -extra-labels string
+    	A comma separated set of extra node labels to display
+  -kubeconfig string
+    	Absolute path to the kubeconfig file (default "~/.kube/config")
+  -node-selector string
+    	Node label selector used to filter nodes, if empty all nodes are selected
+  -node-sort string
+    	Sort order for the nodes, either 'creation' or a label name. The sort order can be controlled by appending =asc or =dsc to the value. (default "creation")
+  -resources string
+    	List of comma separated resources to monitor (default "cpu")
+  -style string
+    	Three color to use for styling 'good','ok' and 'bad' values. These are also used in the gradients displayed from bad -> good. (default "#04B575,#FFFF00,#FF0000")
+  -v	Display eks-node-viewer version
+  -version
+    	Display eks-node-viewer version
+```  
+
+### Examples
+
+```bash
+# Standard usage
+eks-node-viewer
+# Karpenter nodes only
+eks-node-viewer --node-selector karpenter.sh/nodepool
+# Display both CPU and Memory Usage
+eks-node-viewer --resources cpu,memory
+# Display extra labels, i.e. AZ
+eks-node-viewer --extra-labels topology.kubernetes.io/zone
+# Sort by CPU usage in descending order
+eks-node-viewer --node-sort=eks-node-viewer/node-cpu-usage=dsc
+# Specify a particular AWS profile and region
+AWS_PROFILE=myprofile AWS_REGION=us-west-2
+```
+
+#### Computed Labels
+
+Use built‑in computed labels to display node metadata:
+
+- `eks-node-viewer/node-age`  
+- `eks-node-viewer/node-cpu-usage`  
+- `eks-node-viewer/node-memory-usage`  
+- `eks-node-viewer/node-pods-usage`  
+- `eks-node-viewer/node-ephemeral-storage-usage`
+
+#### Default Options
+
+Create a `~/.eks-node-viewer` file to persist your preferred flags:
+
+```text
+# select only Karpenter managed nodes
+node-selector=karpenter.sh/nodepool
+
+# display both CPU and memory
+resources=cpu,memory
+
+# show the zone and nodepool name by default
+extra-labels=topology.kubernetes.io/zone,karpenter.sh/nodepool
+
+# sort so that the newest nodes are first
+node-sort=creation=asc
+
+# change default color style
+style=#2E91D2,#ffff00,#D55E00
+```
+
+---
+
+## Troubleshooting
+
+NoCredentialProviders: no valid providers in chain. Deprecated.
+This CLI relies on AWS credentials to access pricing data if you don't use the `--disable-pricing` option. You must have credentials configured via `~/aws/credentials`, `~/.aws/config`, environment variables, or some other credential provider chain.
+
+---
+
+## References
+* [GitHub - eks-node-viewer](https://github.com/awslabs/eks-node-viewer) 
+* [Containers from the Couch: Workload Consolidation with Karpenter](https://www.youtube.com/watch?v=BnksdJ3oOEs)
+* [AWS re:Invent 2022 - Kubernetes virtually anywhere, for everyone](https://www.youtube.com/watch?v=OB7IZolZk78)
+