lm-cloud-sync 2.0.0__tar.gz

lm_cloud_sync-2.0.0/.env.example

@@ -0,0 +1,67 @@
+# LogicMonitor Configuration
+# Required for all cloud providers
+LM_COMPANY=your-company-name
+LM_BEARER_TOKEN=lmb_your_bearer_token_here
+
+# Alternative: LMv1 Authentication (use instead of bearer token)
+# LM_ACCESS_ID=your_access_id
+# LM_ACCESS_KEY=your_access_key
+
+# ============================================================================
+# GCP Configuration
+# ============================================================================
+
+# Path to GCP service account key JSON file
+# The service account needs 'roles/viewer' or 'roles/resourcemanager.projectViewer'
+# at the organization or folder level for auto-discovery
+GCP_SA_KEY_PATH=/path/to/gcp-service-account-key.json
+
+# Alternative: Use Google Application Default Credentials
+# GOOGLE_APPLICATION_CREDENTIALS=/path/to/gcp-service-account-key.json
+
+# Optional: GCP project ID for API calls (usually auto-detected)
+# GCP_PROJECT_ID=your-gcp-project-id
+
+# ============================================================================
+# AWS Configuration
+# ============================================================================
+
+# AWS credentials for accessing Organizations API
+# The credentials need 'organizations:ListAccounts' permission on the management account
+AWS_ACCESS_KEY_ID=your_aws_access_key_id
+AWS_SECRET_ACCESS_KEY=your_aws_secret_access_key
+
+# Optional: AWS session token (for temporary credentials)
+# AWS_SESSION_TOKEN=your_session_token
+
+# Optional: AWS region (defaults to us-east-1)
+# AWS_DEFAULT_REGION=us-east-1
+
+# Optional: AWS profile name (if using ~/.aws/credentials)
+# AWS_PROFILE=default
+
+# ============================================================================
+# Azure Configuration
+# ============================================================================
+
+# Azure Service Principal credentials
+# The service principal needs 'Reader' role at subscription or management group level
+AZURE_TENANT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+AZURE_CLIENT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+AZURE_CLIENT_SECRET=your_azure_client_secret
+
+# Optional: Specific subscription ID (if not using auto-discovery)
+# AZURE_SUBSCRIPTION_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+
+# ============================================================================
+# Additional Configuration
+# ============================================================================
+
+# Optional: Path to config file (default: config.yaml in current directory)
+# LM_CLOUD_SYNC_CONFIG=/path/to/config.yaml
+
+# Optional: Enable verbose logging
+# LM_CLOUD_SYNC_VERBOSE=true
+
+# Optional: Log level (DEBUG, INFO, WARNING, ERROR)
+# LM_CLOUD_SYNC_LOG_LEVEL=INFO

lm_cloud_sync-2.0.0/.gitignore

@@ -0,0 +1,94 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# uv
+.uv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache/
+
+# Environment and secrets
+.env
+.env.*
+!.env.example
+*.env
+
+# Service account keys
+*.json
+!package.json
+!tsconfig.json
+
+# Local configuration
+config.local.yaml
+config.local.yml
+*.local.yaml
+*.local.yml
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Claude and LLM files
+.claude/
+.claude*
+CLAUDE.md
+CLAUDE.local.md
+
+# Logs
+*.log
+logs/
+
+# Terraform
+*.tfstate
+*.tfstate.*
+.terraform/
+.terraform.lock.hcl
+terraform.tfvars
+!terraform.tfvars.example
+*.tfvars
+!*.tfvars.example

lm_cloud_sync-2.0.0/.python-version

@@ -0,0 +1 @@
+3.11

lm_cloud_sync-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ryan Matuszewski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lm_cloud_sync-2.0.0/PKG-INFO

@@ -0,0 +1,272 @@
+Metadata-Version: 2.4
+Name: lm-cloud-sync
+Version: 2.0.0
+Summary: Multi-cloud automation tool for LogicMonitor integrations. GCP support in v2.0, AWS/Azure coming soon.
+Project-URL: Homepage, https://github.com/ryanmat/lm-cloud-sync
+Project-URL: Repository, https://github.com/ryanmat/lm-cloud-sync
+Project-URL: Issues, https://github.com/ryanmat/lm-cloud-sync/issues
+Author-email: Ryan Matuszewski <rmmatuszewski@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: automation,aws,azure,cloud,gcp,logicmonitor,monitoring
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.11
+Requires-Dist: azure-identity>=1.15.0
+Requires-Dist: azure-mgmt-subscription>=3.1.0
+Requires-Dist: boto3>=1.34.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: google-auth>=2.20.0
+Requires-Dist: google-cloud-resource-manager>=1.10.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: moto[organizations]>=5.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# LM Cloud Sync
+
+Multi-cloud automation tool for LogicMonitor integrations.
+
+Automatically discover and sync cloud resources (AWS accounts, Azure subscriptions, GCP projects) to LogicMonitor as device groups.
+
+## Features
+
+- **GCP Support** (v2.0.0): Full support for Google Cloud Platform
+  - Auto-discovery using Resource Manager API
+  - Project-level integration management
+  - Dry-run mode and orphan detection
+- **Coming Soon**: AWS and Azure support (in development)
+- **CLI & Terraform**: Deploy via command line or infrastructure-as-code
+- **Flexible Authentication**: Bearer token or LMv1 auth
+
+## Installation
+
+### From Source (Current)
+
+This package is not yet published to PyPI. Install from source:
+
+```bash
+# Clone the repository
+git clone https://github.com/ryanmat/lm-cloud-sync.git
+cd lm-cloud-sync
+
+# Option 1: Run directly with uv (recommended for development)
+uv run lm-cloud-sync --help
+
+# Option 2: Install in virtual environment
+uv venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+uv pip install -e .
+lm-cloud-sync --help
+
+# Option 3: Install as a tool globally
+uv tool install --editable .
+lm-cloud-sync --help
+```
+
+### From PyPI (Coming Soon)
+
+Once published, you'll be able to install via:
+
+```bash
+# Using uv
+uv tool install lm-cloud-sync
+
+# Or using pip
+pip install lm-cloud-sync
+```
+
+## Quick Start
+
+### 1. Set Up Environment Variables
+
+Create a `.env` file in your project root (or set environment variables):
+
+```bash
+# Copy the example file
+cp .env.example .env
+
+# Edit .env with your credentials
+# LogicMonitor (required for all providers)
+LM_COMPANY=your-company-name
+LM_BEARER_TOKEN=your-bearer-token
+
+# GCP (if using GCP provider)
+GCP_SA_KEY_PATH=/path/to/service-account.json
+
+# AWS (if using AWS provider)
+AWS_ACCESS_KEY_ID=your-access-key
+AWS_SECRET_ACCESS_KEY=your-secret-key
+
+# Azure (if using Azure provider)
+AZURE_TENANT_ID=your-tenant-id
+AZURE_CLIENT_ID=your-client-id
+AZURE_CLIENT_SECRET=your-client-secret
+```
+
+### 2. Discover GCP Projects
+
+```bash
+# Discover GCP projects
+lm-cloud-sync gcp discover
+
+# With auto-discovery (org-level)
+lm-cloud-sync gcp discover --auto-discover
+```
+
+### 3. Check Sync Status
+
+```bash
+# Check what's already synced vs what needs to be added
+lm-cloud-sync gcp status
+```
+
+### 4. Preview Changes (Dry Run)
+
+```bash
+# See what would be created without making changes
+lm-cloud-sync gcp sync --dry-run
+```
+
+### 5. Execute Sync
+
+```bash
+# Create integrations in LogicMonitor
+lm-cloud-sync gcp sync --yes
+```
+
+## CLI Commands
+
+```
+lm-cloud-sync
+├── gcp               # GCP support (v2.0.0)
+│   ├── discover      # List GCP projects
+│   ├── status        # Show sync status
+│   ├── sync          # Sync projects to LM
+│   └── delete        # Delete an integration
+├── aws               # Coming in v2.1.0
+├── azure             # Coming in v2.2.0
+├── all               # Multi-cloud sync (future)
+└── config
+    ├── init          # Create config file
+    └── validate      # Validate config
+```
+
+### Common Options
+
+```bash
+# Discover with auto-discovery (org-level)
+lm-cloud-sync gcp discover --auto-discover
+
+# Sync with dry-run
+lm-cloud-sync gcp sync --dry-run
+
+# Sync and delete orphaned integrations
+lm-cloud-sync gcp sync --delete-orphans --yes
+
+# Check status with orphan detection
+lm-cloud-sync gcp status --show-orphans
+```
+
+## Configuration
+
+### Environment Variables (v2.0.0)
+
+**Required:**
+| Variable | Description |
+|----------|-------------|
+| `LM_COMPANY` | LogicMonitor portal name |
+| `LM_BEARER_TOKEN` | Bearer token for auth* |
+| `GCP_SA_KEY_PATH` | Path to GCP service account JSON |
+
+*Or use `LM_ACCESS_ID` and `LM_ACCESS_KEY` for LMv1 authentication.
+
+See [.env.example](.env.example) for additional configuration options and future provider support (AWS, Azure).
+
+### Configuration File
+
+Create a config file with `lm-cloud-sync config init`:
+
+```yaml
+logicmonitor:
+  company: "your-company"
+
+gcp:
+  enabled: true
+  filters:
+    exclude_patterns: ["sys-*", "test-*"]
+  regions:
+    - us-central1
+    - us-east1
+  services:
+    - COMPUTEENGINE
+    - CLOUDSQL
+
+sync:
+  dry_run: false
+  delete_orphans: false
+  custom_properties:
+    "lm.cloud.managed_by": "lm-cloud-sync"
+```
+
+## Terraform
+
+See [terraform/](./terraform/) for Terraform modules.
+
+```hcl
+module "gcp_integration" {
+  source = "github.com/ryanmat/lm-cloud-sync//terraform/modules/gcp"
+
+  lm_company    = "your-company"
+  lm_bearer_token = var.lm_bearer_token
+  gcp_project_id  = "my-project"
+  gcp_sa_key_path = "/path/to/key.json"
+}
+```
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/ryanmat/lm-cloud-sync.git
+cd lm-cloud-sync
+
+# Install dependencies
+uv sync --all-extras
+
+# Run tests
+uv run pytest
+
+# Run linting
+uv run ruff check src/
+
+# Run the CLI
+uv run lm-cloud-sync --help
+```
+
+## Roadmap
+
+- [x] **v2.0.0**: GCP support (current release)
+- [ ] **v2.1.0**: AWS support with Organizations discovery
+- [ ] **v2.2.0**: Azure support with Management API discovery
+- [ ] **v3.0.0**: Multi-cloud sync (`lm-cloud-sync all`)
+
+## License
+
+MIT License - see [LICENSE](./LICENSE) for details.

lm_cloud_sync-2.0.0/README.md

@@ -0,0 +1,231 @@
+# LM Cloud Sync
+
+Multi-cloud automation tool for LogicMonitor integrations.
+
+Automatically discover and sync cloud resources (AWS accounts, Azure subscriptions, GCP projects) to LogicMonitor as device groups.
+
+## Features
+
+- **GCP Support** (v2.0.0): Full support for Google Cloud Platform
+  - Auto-discovery using Resource Manager API
+  - Project-level integration management
+  - Dry-run mode and orphan detection
+- **Coming Soon**: AWS and Azure support (in development)
+- **CLI & Terraform**: Deploy via command line or infrastructure-as-code
+- **Flexible Authentication**: Bearer token or LMv1 auth
+
+## Installation
+
+### From Source (Current)
+
+This package is not yet published to PyPI. Install from source:
+
+```bash
+# Clone the repository
+git clone https://github.com/ryanmat/lm-cloud-sync.git
+cd lm-cloud-sync
+
+# Option 1: Run directly with uv (recommended for development)
+uv run lm-cloud-sync --help
+
+# Option 2: Install in virtual environment
+uv venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+uv pip install -e .
+lm-cloud-sync --help
+
+# Option 3: Install as a tool globally
+uv tool install --editable .
+lm-cloud-sync --help
+```
+
+### From PyPI (Coming Soon)
+
+Once published, you'll be able to install via:
+
+```bash
+# Using uv
+uv tool install lm-cloud-sync
+
+# Or using pip
+pip install lm-cloud-sync
+```
+
+## Quick Start
+
+### 1. Set Up Environment Variables
+
+Create a `.env` file in your project root (or set environment variables):
+
+```bash
+# Copy the example file
+cp .env.example .env
+
+# Edit .env with your credentials
+# LogicMonitor (required for all providers)
+LM_COMPANY=your-company-name
+LM_BEARER_TOKEN=your-bearer-token
+
+# GCP (if using GCP provider)
+GCP_SA_KEY_PATH=/path/to/service-account.json
+
+# AWS (if using AWS provider)
+AWS_ACCESS_KEY_ID=your-access-key
+AWS_SECRET_ACCESS_KEY=your-secret-key
+
+# Azure (if using Azure provider)
+AZURE_TENANT_ID=your-tenant-id
+AZURE_CLIENT_ID=your-client-id
+AZURE_CLIENT_SECRET=your-client-secret
+```
+
+### 2. Discover GCP Projects
+
+```bash
+# Discover GCP projects
+lm-cloud-sync gcp discover
+
+# With auto-discovery (org-level)
+lm-cloud-sync gcp discover --auto-discover
+```
+
+### 3. Check Sync Status
+
+```bash
+# Check what's already synced vs what needs to be added
+lm-cloud-sync gcp status
+```
+
+### 4. Preview Changes (Dry Run)
+
+```bash
+# See what would be created without making changes
+lm-cloud-sync gcp sync --dry-run
+```
+
+### 5. Execute Sync
+
+```bash
+# Create integrations in LogicMonitor
+lm-cloud-sync gcp sync --yes
+```
+
+## CLI Commands
+
+```
+lm-cloud-sync
+├── gcp               # GCP support (v2.0.0)
+│   ├── discover      # List GCP projects
+│   ├── status        # Show sync status
+│   ├── sync          # Sync projects to LM
+│   └── delete        # Delete an integration
+├── aws               # Coming in v2.1.0
+├── azure             # Coming in v2.2.0
+├── all               # Multi-cloud sync (future)
+└── config
+    ├── init          # Create config file
+    └── validate      # Validate config
+```
+
+### Common Options
+
+```bash
+# Discover with auto-discovery (org-level)
+lm-cloud-sync gcp discover --auto-discover
+
+# Sync with dry-run
+lm-cloud-sync gcp sync --dry-run
+
+# Sync and delete orphaned integrations
+lm-cloud-sync gcp sync --delete-orphans --yes
+
+# Check status with orphan detection
+lm-cloud-sync gcp status --show-orphans
+```
+
+## Configuration
+
+### Environment Variables (v2.0.0)
+
+**Required:**
+| Variable | Description |
+|----------|-------------|
+| `LM_COMPANY` | LogicMonitor portal name |
+| `LM_BEARER_TOKEN` | Bearer token for auth* |
+| `GCP_SA_KEY_PATH` | Path to GCP service account JSON |
+
+*Or use `LM_ACCESS_ID` and `LM_ACCESS_KEY` for LMv1 authentication.
+
+See [.env.example](.env.example) for additional configuration options and future provider support (AWS, Azure).
+
+### Configuration File
+
+Create a config file with `lm-cloud-sync config init`:
+
+```yaml
+logicmonitor:
+  company: "your-company"
+
+gcp:
+  enabled: true
+  filters:
+    exclude_patterns: ["sys-*", "test-*"]
+  regions:
+    - us-central1
+    - us-east1
+  services:
+    - COMPUTEENGINE
+    - CLOUDSQL
+
+sync:
+  dry_run: false
+  delete_orphans: false
+  custom_properties:
+    "lm.cloud.managed_by": "lm-cloud-sync"
+```
+
+## Terraform
+
+See [terraform/](./terraform/) for Terraform modules.
+
+```hcl
+module "gcp_integration" {
+  source = "github.com/ryanmat/lm-cloud-sync//terraform/modules/gcp"
+
+  lm_company    = "your-company"
+  lm_bearer_token = var.lm_bearer_token
+  gcp_project_id  = "my-project"
+  gcp_sa_key_path = "/path/to/key.json"
+}
+```
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/ryanmat/lm-cloud-sync.git
+cd lm-cloud-sync
+
+# Install dependencies
+uv sync --all-extras
+
+# Run tests
+uv run pytest
+
+# Run linting
+uv run ruff check src/
+
+# Run the CLI
+uv run lm-cloud-sync --help
+```
+
+## Roadmap
+
+- [x] **v2.0.0**: GCP support (current release)
+- [ ] **v2.1.0**: AWS support with Organizations discovery
+- [ ] **v2.2.0**: Azure support with Management API discovery
+- [ ] **v3.0.0**: Multi-cloud sync (`lm-cloud-sync all`)
+
+## License
+
+MIT License - see [LICENSE](./LICENSE) for details.