{"id":17601260,"url":"https://github.com/sam-martin/awstesthelper","last_synced_at":"2025-03-29T21:41:35.765Z","repository":{"id":80868805,"uuid":"99132636","full_name":"Sam-Martin/AWSTestHelper","owner":"Sam-Martin","description":"Set of PowerShell cmdlets for safely spinning AWS VPCs up and down for testing purposes","archived":false,"fork":false,"pushed_at":"2017-12-21T14:03:45.000Z","size":18,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-04T22:25:34.422Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Sam-Martin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2017-08-02T15:29:45.000Z","updated_at":"2020-02-11T17:15:57.000Z","dependencies_parsed_at":"2023-04-15T13:31:35.956Z","dependency_job_id":null,"html_url":"https://github.com/Sam-Martin/AWSTestHelper","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/Sam-Martin%2FAWSTestHelper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sam-Martin%2FAWSTestHelper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sam-Martin%2FAWSTestHelper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sam-Martin%2FAWSTestHelper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sam-Martin","download_url":"https://codeload.github.com/Sam-Martin/AWSTestHelper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246249222,"owners_count":20747167,"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":"2024-10-22T12:09:18.685Z","updated_at":"2025-03-29T21:41:35.741Z","avatar_url":"https://github.com/Sam-Martin.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWSTestHelper [![Build status](https://ci.appveyor.com/api/projects/status/0u01ondgmpo9hel7?svg=true)](https://ci.appveyor.com/project/Sam-Martin/awstesthelper) [![PowerShell Gallery](https://img.shields.io/powershellgallery/dt/AWSTestHelper.svg)]()\n\nSet of PowerShell cmdlets for safely spinning AWS VPCs up and down for testing purposes. \nThis module is useful when you want to quickly spin up an isolated, short-lived instance for testing purposes.\n\n# Usage\nInstallation can be done from the [PowerShell Gallery](https://www.powershellgallery.com/packages/AWSTestHelper/) using the following command.\n\n```\nInstall-Module -Name AWSTestHelper\n```\n\n## VPC Creation\nThis module handles the creation of an AWS VPC including:\n* Internet Gateway\n* 1 x Public Subnet\n* EC2 Role with SSM rights\n\nThis is achieved using the `New-AWSTestEnvironmentStack` cmdlet.\n\n### Example \n```\nNew-AWSTestEnvironmentStack -Region eu-west-1 -ID Default\n```\n\n## Waiting for VPC Creation\nThe creation of a new VPC and resources listed above can take some time. In order to let your script wait for the VPC creation, you can use the `Wait-AWSTestEnvironmentStackCreation` cmdlet.\n\n### Example \n```\nWait-AWSTestEnvironmentStackCreation -Region eu-west-1 -ID Default\n``` \n\n## VPC Discovery\nOnce the VPC has been created you can find the pertinent resource IDs using the `Get-AWSTestEnvironmentStackOutputs` cmdlet.\n\n### Example \n```\nGet-AWSTestEnvironmentStackOutputs -Region eu-west-1 -ID Default\n```\n\n## VPC Deletion\nOnce you have finished with your test VPC, you can delete it using the `Remove-AWSTestEnvironmentStack` cmdlet.\n### Example \n```\nRemove-AWSTestEnvironmentStack -Region eu-west-1 -ID Default -TerminateInstances -Confirm:$false\n```\n*Note:* using the `-TerminateInstances` switch will force the termination of instances launched in the VPC.\n\n## Identity\nYou will note in the examples above that a parameter `-ID` is used in every cmdlet. This identifier is appended to the name of all resources to ensure that they are uniquely identifiable.  \n**Important:** The value you pass to `-ID` is case sensitive.\n\n# Authors\n - Sam Martin (samjackmartin@gmail.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsam-martin%2Fawstesthelper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsam-martin%2Fawstesthelper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsam-martin%2Fawstesthelper/lists"}