{"id":24283606,"url":"https://github.com/containercraft/konductor","last_synced_at":"2025-09-25T03:30:45.007Z","repository":{"id":254619529,"uuid":"846738775","full_name":"ContainerCraft/Konductor","owner":"ContainerCraft","description":"DevOps Template Repository","archived":false,"fork":false,"pushed_at":"2024-12-18T20:04:05.000Z","size":1148,"stargazers_count":9,"open_issues_count":3,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-12-18T20:32:29.756Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ContainerCraft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-23T21:12:27.000Z","updated_at":"2024-12-04T20:03:06.000Z","dependencies_parsed_at":"2024-11-23T01:21:38.912Z","dependency_job_id":"fbf04fb0-4042-42e6-999b-a50b53f0a698","html_url":"https://github.com/ContainerCraft/Konductor","commit_stats":null,"previous_names":["containercraft/konductor"],"tags_count":1,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ContainerCraft%2FKonductor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ContainerCraft%2FKonductor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ContainerCraft%2FKonductor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ContainerCraft%2FKonductor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ContainerCraft","download_url":"https://codeload.github.com/ContainerCraft/Konductor/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234147906,"owners_count":18786934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-16T04:16:56.766Z","updated_at":"2025-09-25T03:30:44.637Z","avatar_url":"https://github.com/ContainerCraft.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Konductor DevOps Template Repository\n\n## Overview\n\nThis repository serves as a comprehensive template for starting new DevOps projects from scratch. It is designed to be cloned as a GitHub template repository, providing a fully-configured environment for deploying and managing cloud-native infrastructure using VSCode with Kubernetes and Pulumi boilerplate as a starting line.\n\nWhether you're building for on-premises, cloud, or local environments, this template streamlines the setup and deployment processes, enabling you to focus on building and innovating.\n\nJoin the community in the [ContainerCraft Community Discord](https://discord.gg/Jb5jgDCksX) to discuss, collaborate, and contribute!\n\n## Features\n\n- **Kubernetes Deployment**: Automated Kubernetes cluster setup using Talos.\n- **Pulumi IaC Integration**: Infrastructure as Code management with Pulumi.\n- **Runme Integration**: Execute documented tasks directly from the README.md.\n- **GitHub Actions Support**: CI/CD pipelines configured for automated testing and deployment.\n\n## Using This Template to Start a New Project\n\nThis repository is designed as a template, allowing you to quickly bootstrap new DevOps projects with a fully-configured environment. Follow the steps below to create a new project from this template.\n\n### Step 1: Create a New Repository from the Template\n\n1. **Navigate to the Template Repository:**\n\n   Visit the [Konductor DevOps Template Repository](https://github.com/ContainerCraft/Konductor) on GitHub.\n\n2. **Use the \"Use this template\" Button:**\n\n   - Click the green `Use this template` button located at the top-right of the repository page.\n   - In the form that appears, provide a name for your new repository and decide if it should be public or private.\n   - Click `Create repository from template` to generate your new repository.\n\n### Step 2: Clone Your New Repository\n\n1. **Clone the Repository to Your Local Machine:**\n\n   Once your new repository is created, clone it to your local machine using Git.\n\n   ```bash\n   git clone https://github.com/YourUsername/YourNewRepoName.git\n   cd YourNewRepoName\n   ```\n\n2. **Initialize the Development Environment:**\n\n   If you're using [GitHub Codespaces](https://github.com/features/codespaces) or a local development environment with Docker, you can launch directly into the pre-configured environment.\n\n   - **GitHub Codespaces:** Click the `Code` button and select `Open with Codespaces`, or follow the instructions in the Quickstart section of this README.\n   - **Local Development:** Follow the instructions in the `Getting Started` section to set up your local environment.\n\n### Step 3: Customize the Configuration\n\n1. **Update Configuration Files:**\n\n   - Customize the `.env` file with your project-specific environment variables.\n   - Modify the `Taskfile.yaml` to include tasks specific to your project.\n   - Adjust the Pulumi configuration files under `.pulumi` to match your cloud and infrastructure setup.\n\n2. **Set Up Your Pulumi Stack:**\n\n   Configure your Pulumi stack settings to match your project environment by following the steps in the `Getting Started` section.\n\n### Step 4: Start Developing\n\n1. **Deploy the Infrastructure:**\n\n   Use the pre-configured tasks to deploy your infrastructure, as detailed in the Quickstart section.\n\n   ```bash\n   task kubernetes\n   task deploy\n   ```\n\n2. **Build and Iterate:**\n\n   With your infrastructure deployed, you can now focus on developing your application, iterating on your DevOps processes, and refining your setup.\n\n### Step 5: Push Your Changes\n\n1. **Commit and Push:**\n\n   After making changes, commit them to your repository.\n\n   ```bash\n   git add .\n   git commit -m \"Initial setup and configuration\"\n   git push origin main\n   ```\n\n2. **Collaborate and Contribute:**\n\n   Share your repository with your team, collaborate on features, and contribute back to the original template if you make improvements that could benefit others.\n\n### Tips for Success\n\n- **Keep your dependencies up to date:** Regularly update the tools and libraries used in your project.\n- **Document your changes:** Update the README and other documentation as your project evolves.\n- **Engage with the community:** Join the [ContainerCraft Community Discord](https://discord.gg/Jb5jgDCksX) to get support and share your experiences.\n\n## How-To (Boilerplate Instructions)\n\nThis repository is designed to be used as a template for new DevOps projects. Follow the steps below to clone and configure your environment.\n\n### Prerequisites\n\nEnsure you have the following tools and accounts:\n\n1. [GitHub](https://github.com)\n2. [Pulumi Cloud](https://app.pulumi.com/signup)\n3. [Microsoft Edge](https://www.microsoft.com/en-us/edge) or [Google Chrome](https://www.google.com/chrome)\n\n### Quickstart\n\nFollow these steps to get your environment up and running:\n\n1. **Clone the Repository:**\n\n   Clone this repository to your GitHub account using the \"Use this template\" button.\n\n2. **Launch in GitHub Codespaces:**\n\n   Start a new GitHub Codespace with the following options:\n\n   - **Branch:** `main`\n   - **Dev Container Configuration:** `konductor`\n   - **Region:** Your choice\n   - **Machine Type:** 4 cores, 16 GB RAM, or better\n\n3. **Open the Integrated Terminal:**\n\n   Use `` Ctrl + ` `` to open the VSCode integrated terminal.\n\n4. **Authenticate Credentials:**\n\n   Login to Pulumi Cloud and other required services.\n\n   ```bash {\"id\":\"01J5VC1KTJBR22WEDNSSGTNAX4\",\"name\":\"login\"}\n   task login\n   ```\n\n5. **Configure the Pulumi Stack:**\n\n   Set up Pulumi stack parameters.\n\n   ```bash {\"id\":\"01J5VC1KTJBR22WEDNSWYBKNQS\",\"name\":\"configure\"}\n   export ORGANIZATION=\"${GITHUB_USER:-${GITHUB_REPOSITORY_OWNER:-}}\"\n   export DEPLOYMENT=\"${RepositoryName:-}\"\n   task configure\n   ```\n\n6. **Deploy Kubernetes:**\n\n   Deploy Kubernetes using Talos.\n\n   ```bash {\"excludeFromRunAll\":\"true\",\"id\":\"01J5VC1KTJBR22WEDNSX4RHEG2\",\"name\":\"kubernetes\"}\n   task kubernetes\n   ```\n\n7. **Deploy the Platform:**\n\n   Deploy the KubeVirt PaaS infrastructure.\n\n   ```bash {\"excludeFromRunAll\":\"true\",\"id\":\"01J5VC1KTJBR22WEDNSZW7QADA\",\"name\":\"deploy\"}\n   task deploy\n   ```\n\n10. **Cleanup:**\n\n    Clean up all Kubernetes and Pulumi resources when you're done.\n\n    ```bash {\"excludeFromRunAll\":\"true\",\"id\":\"01J5VC1KTJBR22WEDNT7BDRMAV\",\"name\":\"clean\"}\n    task clean-all\n    ```\n\n## Contributing\n\nContributions are welcome! This template is intended to evolve with the needs of the community. Learn how to contribute by reading our [CONTRIBUTING.md](https://github.com/ContainerCraft/Konductor/issues/22).\n\n### Developing and Testing\n\nUse the `act` tool to test GitHub Actions locally before pushing your changes.\n\n```bash {\"excludeFromRunAll\":\"true\",\"id\":\"01J5VC1KTJBR22WEDNT92WYZEH\"}\ntask act\n```\n\n## Community and Support\n\nJoin our community to discuss, learn, and contribute:\n\n- **[ContainerCraft Community Discord](https://discord.gg/Jb5jgDCksX)**\n- **[Konductor Project FAQ](FAQ.md)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontainercraft%2Fkonductor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcontainercraft%2Fkonductor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontainercraft%2Fkonductor/lists"}