k8s-helper-cli 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

{k8s_helper_cli-0.2.0.dist-info → k8s_helper_cli-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: k8s-helper-cli
-Version: 0.2.0
+Version: 0.2.2
 Summary: A simplified Python wrapper for common Kubernetes operations
 Author-email: Harshit Chatterjee <harshitchatterjee50@gmail.com>
 License-Expression: MIT
@@ -14,6 +14,8 @@ Requires-Dist: kubernetes>=26.1.0
 Requires-Dist: typer>=0.9.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: pyyaml>=6.0
+Requires-Dist: boto3>=1.26.0
+Requires-Dist: botocore>=1.29.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
@@ -30,8 +32,13 @@ A simplified Python wrapper for common Kubernetes operations that makes it easy
 ## Features
 
 - ✅ **Pod Management**: Create, delete, and list pods
-- ✅ **Deployment Management**: Create, delete, scale, and list deployments
-- ✅ **Service Management**: Create, delete, and list services
+- ✅ **Deployment Management**: Create, delete, scale, and list deployments with init containers
+- ✅ **Service Management**: Create, delete, list services with URL retrieval
+- ✅ **AWS EKS Integration**: Create and manage EKS clusters with automatic configuration
+- ✅ **Secrets Management**: Create, list, and delete Kubernetes secrets
+- ✅ **Persistent Volume Claims**: Create, list, and delete PVCs with multiple access modes
+- ✅ **Service URL Discovery**: Get service URLs including AWS ELB DNS names
+- ✅ **Advanced Deployments**: Support for init containers, volume mounts, and complex configurations
 - ✅ **Resource Monitoring**: Get logs, events, and resource descriptions
 - ✅ **Easy Configuration**: Simple configuration management
 - ✅ **Formatted Output**: Beautiful table, YAML, and JSON output formats
@@ -60,6 +67,13 @@ pip install -e .
 
 **Important**: k8s-helper requires an active Kubernetes cluster connection. Without a properly configured kubectl and accessible cluster, the commands will fail with configuration errors.
 
+### AWS EKS Features Prerequisites
+
+For AWS EKS integration features:
+- AWS CLI configured with appropriate credentials (`aws configure`)
+- AWS IAM permissions for EKS, EC2, and IAM operations
+- boto3 package (automatically installed with k8s-helper-cli)
+
 ### Setting up Kubernetes (Choose one):
 
 1. **Local Development**: 
@@ -702,6 +716,112 @@ k8s-helper --install-completion zsh
 k8s-helper --show-completion bash
 ```
 
+### AWS EKS Integration
+
+```bash
+# Create an EKS cluster
+k8s-helper create-eks-cluster my-cluster --region us-west-2 --version 1.29
+
+# Create EKS cluster with custom settings
+k8s-helper create-eks-cluster my-cluster \
+  --region us-east-1 \
+  --instance-types t3.medium,t3.large \
+  --min-size 2 \
+  --max-size 10 \
+  --desired-size 3 \
+  --node-group my-nodes \
+  --wait
+
+# Note: Requires AWS credentials configured (aws configure)
+```
+
+### Secrets Management
+
+```bash
+# Create a secret
+k8s-helper create-secret my-secret --data "username=admin,password=secret123"
+
+# Create a TLS secret
+k8s-helper create-secret tls-secret --data "tls.crt=cert_content,tls.key=key_content" --type kubernetes.io/tls
+
+# List secrets
+k8s-helper list-secrets --namespace my-namespace
+
+# Delete a secret
+k8s-helper delete-secret my-secret --namespace my-namespace
+```
+
+### Persistent Volume Claims (PVC)
+
+```bash
+# Create a PVC
+k8s-helper create-pvc my-storage 10Gi --access-modes ReadWriteOnce
+
+# Create PVC with specific storage class
+k8s-helper create-pvc my-storage 50Gi --storage-class fast-ssd --access-modes ReadWriteMany
+
+# List PVCs
+k8s-helper list-pvcs --namespace my-namespace
+
+# Delete a PVC
+k8s-helper delete-pvc my-storage --namespace my-namespace
+```
+
+### Service URL Retrieval
+
+```bash
+# Get service URL (including AWS ELB URLs)
+k8s-helper service-url my-service --namespace my-namespace
+
+# Watch for URL changes (useful for LoadBalancer provisioning)
+k8s-helper service-url my-service --watch --namespace my-namespace
+
+# Shows:
+# - ClusterIP access information
+# - NodePort URLs
+# - AWS ELB DNS names for LoadBalancer services
+# - External IPs and hostnames
+```
+
+### Enhanced Application Deployment
+
+```bash
+# Deploy with init container
+k8s-helper apply my-app nginx:latest \
+  --init-container "init-db:postgres:13:pg_isready -h db" \
+  --init-env "PGHOST=db,PGPORT=5432"
+
+# Deploy with PVC mount
+k8s-helper apply my-app nginx:latest \
+  --pvc "my-storage:/data" \
+  --replicas 2
+
+# Deploy with secret mount
+k8s-helper apply my-app nginx:latest \
+  --secret "my-secret:/etc/secrets" \
+  --port 8080
+
+# Deploy with LoadBalancer and show URL
+k8s-helper apply my-app nginx:latest \
+  --service-type LoadBalancer \
+  --wait \
+  --show-url
+
+# Complex deployment with multiple features
+k8s-helper apply my-app nginx:latest \
+  --replicas 3 \
+  --port 8080 \
+  --service-type LoadBalancer \
+  --env "ENV=production,DEBUG=false" \
+  --labels "app=my-app,version=v1.0" \
+  --init-container "migrate:migrate-tool:latest:migrate up" \
+  --init-env "DB_HOST=postgres,DB_PORT=5432" \
+  --secret "db-secret:/etc/db" \
+  --pvc "app-storage:/var/data" \
+  --wait \
+  --show-url
+```
+
 ## Real-World Examples
 
 ### 1. Simple Web Application

k8s_helper_cli-0.2.2.dist-info/RECORD

@@ -0,0 +1,11 @@
+k8s_helper/__init__.py,sha256=_xVS6ZvcjRkEujoKACtnSelsuAF9P1Hl36ALwrglsJo,2666
+k8s_helper/cli.py,sha256=yphZTElwRv873GcYwAQDoonBK_qbj9VSS3Q8fo1aFIE,38671
+k8s_helper/config.py,sha256=P7YdfyvCHprrNs2J9DRb3RrClylfTTh5hfTtDzLug0A,6867
+k8s_helper/core.py,sha256=6qo-IqyL3Obgl4lP2DTXvikIAYLTglb9V9i4FaDVdF4,48991
+k8s_helper/utils.py,sha256=wYgTd5ktyuI-EiVcfW7FrxA7MzXY5odrEKQgmMVdueY,9496
+k8s_helper_cli-0.2.2.dist-info/licenses/LICENSE,sha256=tXPvVl3gLVc6e0qCEoLH9KjeA7z4JVL78UybpvGtBCw,1096
+k8s_helper_cli-0.2.2.dist-info/METADATA,sha256=6eMV6fBAxMNN1dABhXQwl3dC0AlU5RzqgxdLEdDWvHg,26956
+k8s_helper_cli-0.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+k8s_helper_cli-0.2.2.dist-info/entry_points.txt,sha256=IoCMWUZ6mn90LwzQzEy5YkWOwvogDdZ6ycqUWAzCFTQ,50
+k8s_helper_cli-0.2.2.dist-info/top_level.txt,sha256=x9A1jflyer-z2cFnkqk5B42juoH2q0fy5hkT9upsTG8,11
+k8s_helper_cli-0.2.2.dist-info/RECORD,,

k8s_helper_cli-0.2.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-k8s_helper/__init__.py,sha256=Q2GcFYJIwXQ5EmkCG5Tm8NKEKU6e4pKvNsUD1PSZkxg,2666
-k8s_helper/cli.py,sha256=s7O2sxkdrrpVyZcqL9tEQg4gYytkmBSzESqiflx-Xc4,18722
-k8s_helper/config.py,sha256=P7YdfyvCHprrNs2J9DRb3RrClylfTTh5hfTtDzLug0A,6867
-k8s_helper/core.py,sha256=gCQkJSEQ3_ectExB9h1rFvI56Egysg50eVgYtpfquH0,21066
-k8s_helper/utils.py,sha256=wYgTd5ktyuI-EiVcfW7FrxA7MzXY5odrEKQgmMVdueY,9496
-k8s_helper_cli-0.2.0.dist-info/licenses/LICENSE,sha256=tXPvVl3gLVc6e0qCEoLH9KjeA7z4JVL78UybpvGtBCw,1096
-k8s_helper_cli-0.2.0.dist-info/METADATA,sha256=Q4WVmlwoAhp5IT1vgiOGOB-HHv1Xof3uwgpHQpapbUM,23379
-k8s_helper_cli-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-k8s_helper_cli-0.2.0.dist-info/entry_points.txt,sha256=IoCMWUZ6mn90LwzQzEy5YkWOwvogDdZ6ycqUWAzCFTQ,50
-k8s_helper_cli-0.2.0.dist-info/top_level.txt,sha256=x9A1jflyer-z2cFnkqk5B42juoH2q0fy5hkT9upsTG8,11
-k8s_helper_cli-0.2.0.dist-info/RECORD,,