{"id":14064551,"url":"https://github.com/Badgerati/Picassio2","last_synced_at":"2025-07-29T18:33:00.380Z","repository":{"id":146595628,"uuid":"100182332","full_name":"Badgerati/Picassio2","owner":"Badgerati","description":"Picassio2 is a Code-over-Config version of Picassio, and far more flexible for automation using PowerShell","archived":false,"fork":false,"pushed_at":"2018-02-11T16:43:42.000Z","size":100,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-11-23T10:41:53.565Z","etag":null,"topics":["automation","deployment","iis","parallel","powershell","powershell-module","provisioning","remote","slack","windows","windows-features"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Badgerati.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2017-08-13T14:30:10.000Z","updated_at":"2024-01-12T10:49:48.000Z","dependencies_parsed_at":"2024-02-15T00:46:32.060Z","dependency_job_id":null,"html_url":"https://github.com/Badgerati/Picassio2","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Badgerati%2FPicassio2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Badgerati%2FPicassio2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Badgerati%2FPicassio2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Badgerati%2FPicassio2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Badgerati","download_url":"https://codeload.github.com/Badgerati/Picassio2/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228040710,"owners_count":17860211,"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":["automation","deployment","iis","parallel","powershell","powershell-module","provisioning","remote","slack","windows","windows-features"],"created_at":"2024-08-13T07:03:55.580Z","updated_at":"2024-12-04T03:31:01.962Z","avatar_url":"https://github.com/Badgerati.png","language":"PowerShell","funding_links":[],"categories":["PowerShell"],"sub_categories":[],"readme":"# Picassio2\n\n[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/Badgerati/Fudge/master/LICENSE.txt)\n\nPicassio2 is a redesigned [Picassio](https://github.com/Badgerati/Picassio) that is `code-over-config`.\nInstead of writing a JSON file with steps to run, you can now import the Picassio2 module and write your deployment/automation steps in pure PowerShell. Giving you all the flexibility you could want - you can even run steps in parallel and on remote servers.\n\n* [Installing Picassio2](#installing-picassio2)\n* [Features](#features)\n* [Description](#description)\n* [Example Scripts](#example-scripts)\n* [Extensions](#extensions)\n* [Bugs and Feature Requests](#bugs-and-feature-requests)\n\n## Installing Picassio2\n\nComing soon via `Install-Module` and `Chocolatey`.\n\n## Features\n\nPicassio2 allows you to write deployment and automation steps completely in PowerShell, meaning you could just use the `Step` option and then do whatever you want.\nThough to make your lives easier, Picassio2 comes with some inbuilt functions:\n\n* Ability to use general PowerShell inside and outside of Picassio2's steps\n* Archive and Extract files/directories with 7-zip\n* Run Cake build scripts for your projects\n* Copy files/directories, create temporary directories, and create temporary network drives to remote systems\n* Create and remove websites, application pools and bindings in IIS\n* Create and remove Windows Services\n* Install and uninstall Windows Features and Optional Features\n* Test if software is installed and fail if not installed\n* Setup ACL permissions on files and directories\n* Run steps on remote machines - requires Picassio2 to be installed on remote machine\n* Install software using chocolatey (will self-install chocolatey)\n* Manage databases using SSDT scripts\n* Post messages to Slack channels!\n* And many more...\n\n## Description\n\nPicassio2 is a PowerShell module that helps with automating deployment tasks on local or remote servers.\n\nWith Picassio2 there are no JSON, YAML, or any other configuration files - everything is written purely in PowerShell.\nUnlike with the first Picassio where you needed a JSON file with defined steps, you can now import Picassio2 as a module and then just run the script as you would any other PowerShell script.\n\n## Example Scripts\n\n* Example of running single steps\n\n```powershell\nImport-Module Picassio2\n\nStep 'Archive' {\n    # archive a directory\n    Invoke-PicassioArchive -Path 'C:\\path\\to\\some\\folder' -ZipPath 'C:\\path\\to\\some\\folder.7z'\n}\n\nWrite-Host 'Random PowerShell between steps!'\n\nStep 'Build Solution' {\n    # run a cake build script\n    Invoke-PicassioCake -Path 'C:\\path\\to\\your\\repo'\n}\n\nStep 'Name' {\n    # plus any other powershell you want\n}\n```\n\n* Example of running a single step on a remote machine\n\n\u003e Picassio2 *will* need to be installed on the remote machine\n\n```powershell\nImport-Module Picassio2\n\nStep 'Install Features' -ComputerName 'Name' -Credentials (Get-Credential) {\n    # install iis on remote machine\n    Install-PicassioWindowsFeature -Name 'Web-Server' -IncludeAllSubFeatures\n}\n```\n\n* Example of running steps in parallel\n\n```powershell\nImport-Module Picassio2\n\nParallelStep 'Multiple Cake Builds' @(\n    {\n        Invoke-PicassioCake -Path 'C:\\path\\to\\your\\repo1'\n    },\n    {\n        Invoke-PicassioCake -Path 'C:\\path\\to\\your\\repo2'\n    },\n    {\n        Invoke-PicassioCake -Path 'C:\\path\\to\\your\\repo3'\n    }\n)\n```\n\nHow do you run these scripts? Well, if you save the last example as `build-cake.ps1`, then to run it just do:\n\n```powershell\n\u003e .\\build-cake.ps1\n```\n\nYes, it's that simple!\n\n## Extensions\n\nThis is a feature pulled over from the original Picassio: Extension scripts. If you have scripts you want to use via Picassio2, and want their functions to be loaded with Picassio2 then place them at:\n\n```plain\nC:\\Picassio2\\Extensions\n```\n\nAny PowerShell (`*.ps1`) scripts here will be loaded with the Picassio2 module. If you use remoting any of your steps, then these extensions *will* have to exist on the remote machines as well.\n\n## Bugs and Feature Requests\n\nFor any bugs you may find or features you wish to request, please create an [issue](https://github.com/Badgerati/Picassio2/issues \"Issues\") in GitHub.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBadgerati%2FPicassio2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBadgerati%2FPicassio2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBadgerati%2FPicassio2/lists"}