vm-tool 1.0.4__tar.gz → 1.0.40__tar.gz

vm_tool-1.0.40/.devcontainer/devcontainer.json

@@ -0,0 +1,18 @@
+{
+	"name": "VM Tool Dev",
+	"image": "mcr.microsoft.com/devcontainers/python:1-3.12-bullseye",
+	"features": {
+		"ghcr.io/devcontainers/features/docker-outside-of-docker:1": {}
+	},
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"ms-python.python",
+				"ms-python.flake8",
+				"charliermarsh.ruff",
+				"redhat.ansible"
+			]
+		}
+	},
+	"postCreateCommand": "pip install -e .[dev] && pip install pre-commit && pre-commit install"
+}

vm_tool-1.0.40/.github/dependabot.yml

@@ -0,0 +1,19 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      dependencies:
+        patterns:
+          - "*"
+  
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      dependencies:
+        patterns:
+          - "*"

vm_tool-1.0.40/.github/workflows/ci.yml

@@ -0,0 +1,57 @@
+name: CI
+
+on:
+    push:
+        branches: [main]
+    pull_request:
+        branches: [main]
+
+jobs:
+    test:
+        runs-on: ubuntu-latest
+        strategy:
+            matrix:
+                python-version: ["3.10", "3.11", "3.12"]
+
+        steps:
+            - uses: actions/checkout@v6
+
+            - name: Set up Python ${{ matrix.python-version }}
+              uses: actions/setup-python@v6
+              with:
+                  python-version: ${{ matrix.python-version }}
+
+            - name: Install dependencies
+              run: |
+                  python -m pip install --upgrade pip
+                  pip install flake8 pytest
+                  if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+                  pip install -e .[dev]
+
+            - name: Lint with flake8
+              run: |
+                  # stop the build if there are Python syntax errors or undefined names
+                  flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+                  # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+                  flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+
+            - name: Test with pytest
+              run: |
+                  pytest
+
+    security:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v6
+
+            - name: Set up Python
+              uses: actions/setup-python@v6
+              with:
+                  python-version: "3.12"
+
+            - name: Install Bandit
+              run: pip install bandit
+
+            - name: Run Bandit Scan
+              # -r: recursive, -ll: log level (only high/medium), -ii: confidence level
+              run: bandit -r vm_tool -ll -ii

vm_tool-1.0.40/.github/workflows/deploy.yml

@@ -0,0 +1,207 @@
+name: Deploy to EC2 with vm_tool
+
+on:
+  push:
+    branches: [ develop ]
+  pull_request:
+    branches: [ develop ]
+  workflow_dispatch:
+
+env:
+  EC2_HOST: ${{ secrets.EC2_HOST }}
+  EC2_USER: ${{ secrets.EC2_USER }}
+  APP_PORT: 8000
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Validate Required Secrets
+        run: |
+          echo "🔐 Validating GitHub Secrets..."
+          MISSING_SECRETS=()
+          
+          if [ -z "${{ secrets.EC2_HOST }}" ]; then
+            MISSING_SECRETS+=("EC2_HOST")
+          fi
+          
+          if [ -z "${{ secrets.EC2_USER }}" ]; then
+            MISSING_SECRETS+=("EC2_USER")
+          fi
+          
+          if [ -z "${{ secrets.EC2_SSH_KEY }}" ]; then
+            MISSING_SECRETS+=("EC2_SSH_KEY")
+          fi
+          
+          if [ ${#MISSING_SECRETS[@]} -ne 0 ]; then
+            echo ""
+            echo "❌ ERROR: Missing required GitHub Secrets!"
+            echo ""
+            echo "Missing: ${MISSING_SECRETS[*]}"
+            echo ""
+            echo "📝 How to add secrets:"
+            echo "1. Go to: Repository → Settings → Secrets → Actions"
+            echo "2. Add each secret:"
+            echo ""
+            
+            if [[ " ${MISSING_SECRETS[*]} " =~ " EC2_HOST " ]]; then
+              echo "   EC2_HOST: Your EC2 IP (e.g., 54.123.45.67)"
+            fi
+            
+            if [[ " ${MISSING_SECRETS[*]} " =~ " EC2_USER " ]]; then
+              echo "   EC2_USER: SSH username (e.g., ubuntu)"
+            fi
+            
+            if [[ " ${MISSING_SECRETS[*]} " =~ " EC2_SSH_KEY " ]]; then
+              echo "   EC2_SSH_KEY: Run 'cat ~/.ssh/id_rsa' and copy output"
+            fi
+            
+            echo ""
+            echo "📚 See: docs/ssh-key-setup.md"
+            exit 1
+          fi
+          
+          echo "✅ All secrets configured"
+
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '{self.python_version}'
+
+      - name: Install vm_tool
+        run: pip install vm-tool
+
+      - name: Lint with flake8
+        run: |
+          pip install flake8
+          # stop the build if there are Python syntax errors or undefined names
+          flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+          # exit-zero treats all errors as warnings.
+          flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+
+      - name: Test with pytest
+        run: |
+          pip install pytest
+          pytest
+
+      - name: Set up SSH
+        run: |
+          mkdir -p ~/.ssh
+          echo "${{ secrets.EC2_SSH_KEY }}" > ~/.ssh/deploy_key
+          chmod 600 ~/.ssh/deploy_key
+          ssh-keyscan -H ${{ secrets.EC2_HOST }} >> ~/.ssh/known_hosts
+
+      - name: Validate SSH Connection
+        run: |
+          echo "✅ Testing SSH connection..."
+          ssh -i ~/.ssh/deploy_key -o StrictHostKeyChecking=no \
+            ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} "echo 'Connected'" || {
+            echo "❌ SSH failed! Check docs/ssh-key-setup.md"
+            exit 1
+          }
+
+      - name: Copy docker-compose to EC2
+        run: |
+          ssh -i ~/.ssh/deploy_key ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} \
+            'mkdir -p ~/app'
+          
+          scp -i ~/.ssh/deploy_key docker-compose.yml \
+            ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }}:~/app/
+          
+          # Copy any .env files if they exist
+          if [ -f .env.production ]; then
+            scp -i ~/.ssh/deploy_key .env.production \
+              ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }}:~/app/.env
+          fi
+
+      - name: Create backup
+        run: |
+          ssh -i ~/.ssh/deploy_key ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} << 'EOF'
+            mkdir -p ~/backups
+            if [ -d ~/app ]; then
+              tar -czf ~/backups/backup-$(date +%Y%m%d-%H%M%S).tar.gz -C ~/app . 2>/dev/null || true
+              echo "✅ Backup created"
+            fi
+          EOF
+
+      - name: Dry-run
+        run: |
+          echo "🔍 DRY-RUN: Previewing deployment"
+          ssh -i ~/.ssh/deploy_key ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} << 'EOF'
+            cd ~/app && docker-compose config
+          EOF
+
+      - name: Deploy with vm_tool (Ansible-based)
+        run: |
+          # Create inventory file for Ansible
+          cat > inventory.yml << EOF
+          all:
+            hosts:
+              production:
+                ansible_host: ${{ secrets.EC2_HOST }}
+                ansible_user: ${{ secrets.EC2_USER }}
+                ansible_ssh_private_key_file: ~/.ssh/deploy_key
+          EOF
+          
+          # Deploy using vm_tool (uses Ansible under the hood)
+          vm_tool deploy-docker \
+            --host ${{ secrets.EC2_HOST }} \
+            --user ${{ secrets.EC2_USER }} \
+            --compose-file ~/app/docker-compose.yml \
+            --inventory inventory.yml \
+            --force
+
+      - name: Health check
+        run: |
+          for i in {{1..30}}; do
+            if curl -f http://${{ secrets.EC2_HOST }}:8000/health 2>/dev/null; then
+              echo "✅ Health check passed"
+              exit 0
+            fi
+            sleep 2
+          done
+          echo "❌ Health check failed"
+          exit 1
+
+      - name: Verify
+        run: |
+          ssh -i ~/.ssh/deploy_key ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} << 'EOF'
+            cd ~/app
+            docker-compose ps
+            docker-compose logs --tail=20
+          EOF
+
+      - name: Rollback on failure
+        if: failure()
+        run: |
+          echo "⚠️  Rolling back..."
+          ssh -i ~/.ssh/deploy_key ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} << 'EOF'
+            BACKUP=$(ls -t ~/backups/*.tar.gz 2>/dev/null | head -1)
+            if [ -n "$BACKUP" ]; then
+              cd ~/app && tar -xzf $BACKUP
+              docker-compose up -d
+              echo "✅ Rolled back"
+            fi
+          EOF
+
+      - name: Cleanup
+        if: success()
+        run: |
+          ssh -i ~/.ssh/deploy_key ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} << 'EOF'
+            cd ~/backups 2>/dev/null || exit 0
+            ls -t *.tar.gz 2>/dev/null | tail -n +6 | xargs rm -f || true
+          EOF
+
+      - name: Notify
+        if: always()
+        run: |
+          if [ "${{ job.status }}" == "success" ]; then
+            echo "✅ Deployed to ${{ secrets.EC2_HOST }}:${{ env.APP_PORT }}"
+          else
+            echo "❌ Deployment failed"
+          fi

vm_tool-1.0.40/.github/workflows/publish.yml

@@ -0,0 +1,37 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-n-publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/vm-tool
+    permissions:
+      id-token: write # IMPORTANT: mandatory for trusted publishing
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

vm_tool-1.0.40/.gitignore

@@ -0,0 +1,35 @@
+# Project-specific files
+project/
+
+# Virtual environments
+venv/
+.env/
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+
+# Python-specific files
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+
+# Jupyter Notebook checkpoints
+.ipynb_checkpoints/
+
+# Logs
+*.log
+
+# OS-specific files
+.DS_Store
+Thumbs.db
+
+# IDE-specific files
+.vscode/
+.idea/
+*.sublime-project
+*.sublime-workspace
+
+dynamic_inventory.yml

vm_tool-1.0.40/.pre-commit-config.yaml

@@ -0,0 +1,14 @@
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+    -   id: trailing-whitespace
+    -   id: end-of-file-fixer
+    -   id: check-yaml
+    -   id: check-added-large-files
+
+-   repo: https://github.com/pycqa/flake8
+    rev: 7.0.0
+    hooks:
+    -   id: flake8
+        args: [--max-line-length=127]

vm_tool-1.0.40/CONTRIBUTING

@@ -0,0 +1,57 @@
+## Initial Setup of the Application
+
+1. **Connect to the deployment machine using VSCode.**
+   - Open VSCode.
+   - Use the SSH extension to connect to your deployment machine.
+
+2. **Install the package and its dependencies:**
+   ```bash
+   pip install .
+   ```
+
+3. **Raise a Pull Request (PR):**
+   - Ensure the issue you are addressing is resolved.
+   - Write a clear and concise description of the changes made in the PR.
+
+---
+
+## Contributing Guidelines
+
+We welcome contributions to improve this tool! Here are the steps to contribute:
+
+1. **Fork the repository:**
+   - Navigate to the repository and click the "Fork" button.
+
+2. **Clone your fork:**
+   ```bash
+   git clone https://github.com/thesunnysinha/vm_tool.git
+   cd vm-tool
+   ```
+
+3. **Create a new branch:**
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+4. **Make changes:**
+   - Ensure your code follows best practices.
+   - Test your changes locally before committing.
+
+5. **Commit and push your changes:**
+   ```bash
+   git add .
+   git commit -m "Add description of changes"
+   git push origin feature/your-feature-name
+   ```
+
+6. **Submit a PR:**
+   - Go to the original repository and click "New Pull Request."
+   - Provide a detailed description of your changes, including the issue it resolves.
+
+7. **Review process:**
+   - Wait for maintainers to review your PR.
+   - Address any feedback promptly.
+
+---
+
+Thank you for contributing to the VM Setup Tool!

vm_tool-1.0.40/CONTRIBUTING.md

@@ -0,0 +1,40 @@
+# Contributing to VM Tool
+
+## Code Organization
+
+VM Tool follows a modular architecture with clear separation of concerns:
+
+- `vm_tool/core/` - Core infrastructure (config, state, history)
+- `vm_tool/strategies/` - Deployment strategies (blue-green, canary, A/B)
+- `vm_tool/operations/` - Operations (metrics, alerting, reporting)
+- `vm_tool/enterprise/` - Enterprise features (RBAC, audit, policy)
+- `vm_tool/integrations/` - External integrations (webhooks, notifications)
+
+## Adding Features
+
+1. Determine the appropriate module directory
+2. Create module with clear, focused responsibility
+3. Add comprehensive tests
+4. Update documentation
+5. Submit pull request
+
+See `docs/code_organization.md` for detailed guidelines.
+
+## Testing
+
+```bash
+# Run all tests
+pytest -v
+
+# Run specific module tests
+pytest tests/unit/test_<module>.py -v
+
+# Run integration tests
+pytest tests/integration/ -v
+```
+
+## Documentation
+
+- Update API docs in `docs/api/`
+- Add usage examples in `docs/guides/`
+- Update `CHANGELOG.md`

vm_tool-1.0.40/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include vm_tool/vm_setup *

vm_tool-1.0.40/Makefile

@@ -0,0 +1,19 @@
+.PHONY: clean build upload install version-control
+
+# Clean up previous builds
+clean:
+	rm -rf dist
+
+# Build the source distribution
+build: clean
+	mkdir -p dist
+	python setup.py sdist
+
+# Upload the distribution to PyPI
+upload: build
+	pip install --upgrade twine
+	twine upload dist/* --verbose
+
+# Install dependencies
+install:
+	pip install -r requirements.txt