pdt

pdt - Process Deploy Tool

pdt is an open-source tool designed to simplify the deployment and scheduling of jobs across various cloud environments, including AWS, Azure, Google Cloud, and Windows Task Scheduler. The tool enables users to turn any script into a scheduled job without the need for additional servers or installations, allowing all configurations and jobs to reside securely within the user's own cloud account.

Key Features

• Script Integration: Easily integrate existing PowerShell or Python scripts into pdt. The tool identifies dependencies and facilitates the execution of these scripts effortlessly.
• Simplified Deployment: Deploying a scheduled job is straightforward with pdt. The command pdt deploy guides users through the installation of necessary tools and presents a user-friendly sign-in page to set up the environment.
• Cross-Cloud Flexibility: Change cloud platforms with a simple configuration switch, allowing jobs to transition seamlessly between AWS, Azure, Google Cloud, and Windows environments.
• Cost Transparency: View a detailed plan along with a monthly cost estimation prior to deploying any changes, ensuring budget management for cloud resources.
• Monitoring & Alerts: Keep track of job performance with health checks, comprehensive logs, and real-time alerts sent to Slack, Teams, or email.

Job Management Primitives

pdt standardizes job components across different cloud platforms, utilizing the same building blocks for all jobs. The following table outlines the primitives used:

Best Practices

• One Folder Per Job: Each job is managed independently, ensuring clean builds, deployments, and destructions.
• Local Testing: Utilize the pdt run command to test jobs in a local environment, mirroring cloud configurations and storage.
• Ownership of Jobs: Jobs are maintained within the user's own git repository and cloud account, with no external servers involved.
• Security Management: Utilize .env files for secret management, keeping sensitive information secure and out of version control.
• Resource Efficiency: Jobs are designed to run only when scheduled, using the most cost-effective options and configurations available.
• State Management: During execution, a job's state remains locked, preventing overlaps that could affect data integrity.

Getting Started

For an initial setup, users can easily create and deploy their own scripts with commands like:

pdt init jobs
cd jobs
pdt new hello-powershell --from powershell-hello-world
cd hello-powershell
pdt run
pdt deploy
pdt logs

Example Deployments

Users have access to various bundled examples to streamline their setup, such as:

• hello-world: A simple job that logs "Hello, world."
• azure-license-waste: A PowerShell job that checks for unused Microsoft 365 licenses and generates reports.

Documentation

Comprehensive documentation is available, covering topics such as creating projects, deploying jobs, job commands, selecting operating environments, and logging. This ensures users have the necessary resources to make full use of pdt's capabilities.