gitlab.psm1
|
# Implement your module commands in this script. $ErrorActionPreference = "Stop" $ProgressPreference = "SilentlyContinue" function Receive-GitlabGroup { [CmdletBinding()] <# .SYNOPSIS Returns Gitlab Groups .DESCRIPTION Returns All Gitlab groups that token has permission. .EXAMPLE PS C:\> Receive-GitlabGroups -connection @{uri="http://localhost/api/v4/";token="qweasd123asd"} id : 2 web_url : http://localhost/groups/Devops name : Devops path : Devops description : visibility : private share_with_group_lock : False require_two_factor_authentication : False two_factor_grace_period : 48 project_creation_level : developer auto_devops_enabled : subgroup_creation_level : maintainer emails_disabled : mentions_disabled : lfs_enabled : True avatar_url : request_access_enabled : True full_name : Devops full_path : Devops parent_id : .INPUTS N/A .OUTPUTS N/A .PARAMETER connection A hash object which contains uri and token attributes. .NOTES General notes #> param ( # Connection info for Gitlab [Parameter(Mandatory=$false)] [ValidateNotNullOrEmpty()] [ValidateScript({ [System.Uri]::IsWellFormedUriString($_.uri,[System.UriKind]::Absolute) ? $true : $(Throw "URL is invalid: $($_.uri)") && [String]::IsNullOrWhiteSpace($_.token) ? $(Throw "Token cannot be empty") : $true })] $connection ) begin { } process { try { $reqID = Get-Random -Minimum 1 -Maximum 999999999 $headers = @{ Authorization = "Bearer $($connection.token)" } $result = $null $page = 1 do { $url = [Uri]::new([Uri]::new($connection.uri), "groups?page=$page").ToString() Write-Verbose -Message "$(get-date -Format 'yyyyMMddHHmmss') - $($PSCmdlet.MyInvocation.MyCommand.Name) - ReqID:$reqID -> Created url:$url" $response = Invoke-WebRequest -Uri $url -Headers $headers -SkipCertificateCheck $result += $response.Content | ConvertFrom-Json $page ++ } while ($page -le $response.Headers."X-Total-Pages"[0]) #X-Total-Pages returns number of page size in an array list. Write-Verbose -Message "$(get-date -Format 'yyyyMMddHHmmss') - $($PSCmdlet.MyInvocation.MyCommand.Name) - ReqID:$reqID -> Returns result:$result" return $result } catch { throw $PSItem } } end { } } function New-GitlabGroup { [CmdletBinding()] <# .SYNOPSIS Creates Gitlab Group .DESCRIPTION Creates New Group or Subgroup in Gitlab .EXAMPLE PS C:\> New-GitlabGroup -name "myGroup" -connection @{uri="http://localhost/api/v4/";token="qweasd123asd"} Creates new group .EXAMPLE PS C:\> New-GitlabGroup -name "myGroup" -connection @{uri="http://localhost/api/v4/";token="qweasd123asd"} -parentID 2 Creates new subgroup in groupID 2 .INPUTS N/A .OUTPUTS N/A .NOTES General notes .PARAMETER name Name of the gitlab group .PARAMETER parentID Parent ID of the subgroup .PARAMETER connection A hash object which contains uri and token attributes. #> param ( # ParentID of subgroup [Parameter(Mandatory=$false)] [ValidateNotNullOrEmpty()] $parentID, # Group name [Parameter(Mandatory=$false)] [ValidateNotNullOrEmpty()] [String] $name, # Connection info for Gitlab [Parameter(Mandatory=$false)] [ValidateNotNullOrEmpty()] [ValidateScript({ [System.Uri]::IsWellFormedUriString($_.uri,[System.UriKind]::Absolute) ? $true : $(Throw "URL is invalid: $($_.uri)") && [String]::IsNullOrWhiteSpace($_.token) ? $(Throw "Token cannot be empty") : $true })] $connection ) begin { } process { try { $reqID = Get-Random -Minimum 1 -Maximum 999999999 $headers = @{ Authorization = "Bearer $($connection.token)" } [String]::IsNullOrWhiteSpace($parentID) ? $($query = "groups?name=$name&path=$name") : $($query = "groups?name=$name&path=$name&parent_id=$parentID") $url = [Uri]::new([Uri]::new($connection.uri), $query ).ToString() Write-Verbose -Message "$(get-date -Format 'yyyyMMddHHmmss') - $($PSCmdlet.MyInvocation.MyCommand.Name) - ReqID:$reqID -> Created url:$url" $result = Invoke-RestMethod -Uri $url -Headers $headers -Method Post -SkipCertificateCheck Write-Verbose -Message "$(get-date -Format 'yyyyMMddHHmmss') - $($PSCmdlet.MyInvocation.MyCommand.Name) - ReqID:$reqID -> Returns result:$result" return $result } catch { throw $PSItem } } end { } } function New-GitlabProject { [CmdletBinding()] <# .SYNOPSIS Creates Gitlab Project .DESCRIPTION Creates New Project for given group id .EXAMPLE PS C:\> New-GitlabProject -name "myPrj" -connection @{uri="http://localhost/api/v4/";token="qweasd123asd"} -groupID 2 Creates new project "myPrj" in groupID 2 .INPUTS N/A .OUTPUTS N/A .NOTES General notes .PARAMETER name Name of the gitlab project .PARAMETER parentID Parent ID of the project .PARAMETER connection A hash object which contains uri and token attributes. #> param ( # ID of group [Parameter(Mandatory=$false)] [ValidateNotNullOrEmpty()] $groupID, # Project name [Parameter(Mandatory=$false)] [ValidateNotNullOrEmpty()] [String] $name, # Connection info for Gitlab [Parameter(Mandatory=$false)] [ValidateNotNullOrEmpty()] [ValidateScript({ [System.Uri]::IsWellFormedUriString($_.uri,[System.UriKind]::Absolute) ? $true : $(Throw "URL is invalid: $($_.uri)") && [String]::IsNullOrWhiteSpace($_.token) ? $(Throw "Token cannot be empty") : $true })] $connection ) begin { } process { try { $reqID = Get-Random -Minimum 1 -Maximum 999999999 $headers = @{ Authorization = "Bearer $($connection.token)" } $url = [Uri]::new([Uri]::new($connection.uri), "projects" ).ToString() $body = @{ name = $name namespace_id = $groupID } Write-Verbose -Message "$(get-date -Format 'yyyyMMddHHmmss') - $($PSCmdlet.MyInvocation.MyCommand.Name) - ReqID:$reqID -> Created url:$url" Write-Verbose -Message "$(get-date -Format 'yyyyMMddHHmmss') - $($PSCmdlet.MyInvocation.MyCommand.Name) - ReqID:$reqID -> Created body:$($body|out-string)" $result = Invoke-RestMethod -Uri $url -Headers $headers -Body $body -Method Post -SkipCertificateCheck Write-Verbose -Message "$(get-date -Format 'yyyyMMddHHmmss') - $($PSCmdlet.MyInvocation.MyCommand.Name) - ReqID:$reqID -> Returns result:$result" return $result } catch { throw $PSItem } } end { } } # Export only the functions using PowerShell standard verb-noun naming. # Be sure to list each exported functions in the FunctionsToExport field of the module manifest file. # This improves performance of command discovery in PowerShell. Export-ModuleMember -Function *-* |