https://github.com/chris-peterson/pwsh-artifactory

Interact with Artifactory via Powershell
https://github.com/chris-peterson/pwsh-artifactory

api artifactory cli module powershell pwsh rest rest-api

Last synced: 27 days ago
JSON representation

Interact with Artifactory via Powershell

• Host: GitHub
• URL: https://github.com/chris-peterson/pwsh-artifactory
• Owner: chris-peterson
• License: mit
• Created: 2023-01-10T00:16:25.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-01-19T01:15:22.000Z (10 months ago)
• Last Synced: 2024-01-19T02:34:47.147Z (10 months ago)
• Topics: api, artifactory, cli, module, powershell, pwsh, rest, rest-api
• Language: PowerShell
• Homepage:
• Size: 22.5 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Overview

Module for interacting with [Artifactory's REST API](https://www.jfrog.com/confluence/display/JFROG/Artifactory+REST+API#ArtifactoryRESTAPI-DeleteItemFromTrashCan).

## Status

[![PowerShell Gallery Version](https://img.shields.io/powershellgallery/v/ArtifactoryCli)](https://www.powershellgallery.com/packages/ArtifactoryCli)

[![PowerShell Gallery](https://img.shields.io/powershellgallery/dt/ArtifactoryCli?color=green)](https://www.powershellgallery.com/packages/ArtifactoryCli)

[![GitHub license](https://img.shields.io/github/license/chris-peterson/pwsh-artifactory.svg)](LICENSE)

[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/chris-peterson/pwsh-artifactory/deploy.yml?branch=main&label=ci)](https://github.com/chris-peterson/pwsh-artifactory/actions/workflows/deploy.yml)

## Setup

```powershell

$env:ARTIFACTORY_ENDPOINT='https://myartifactory.mydomain.local'

$env:ARTIFACTORY_ACCESS_TOKEN ='my-artifactory-access-token"

Import-Module ArtifactoryCli

```

## Examples

### `Get-ArtifactoryItem`

```powershell

Get-ArtifactoryItem 'docker'

```

```text

Repo   Path Last Modified        Child Count Uri

----   ---- -------------        ----------- ---

docker /    2/2/2018 10:21:32 PM         197 https://myartifactory.mydomain.local/artifactory/api/storage/docker

```

### `Get-ArtifactoryChildItem`

```powershell

Get-ArtifactoryChildItem 'docker'

```

OR

```powershell

Get-ArtifactoryItem 'docker' | Get-ArtifactoryChildItem

```

```text

Uri                                                            IsFolder

---                                                            --------

https://myartifactory.mydomain.local/artifactory/docker/imagea True

https://myartifactory.mydomain.local/artifactory/docker/imageb True

...

```

### `Remove-ArtifactoryItem`

In order to avoid timeouts (and to minimize risk), the best way to remove items is by specific tags as opposed to by folder / repository.

Example:

```powershell

Get-ArtifactoryItem 'docker/imagea' | Get-ArtifactoryChildItem | ForEach-Object { $_ | Remove-ArtifactoryItem -Confirm }

```

```text

Performing the operation "delete item" on target

""https://myartifactory.mydomain.local/artifactory/docker/imagea/build123456".

[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help

(default is "Y"):

```

### `Get-ArtifactoryStorageInfo`

```powershell

Get-ArtifactoryStorageInfo

```

```text

Binaries                   Files                         Repos                      Repo Count Largest Repos

--------                   -----                         -----                      ---------- -------------

21.14 TB (1,546,703 items) 12.70 GB (17.23%) of 73.70 GB 64.95 TB (4,620,805 items)        151 docker, auto-trashcan, foo, bar, xyz

```

```powershell

Get-ArtifactoryStorageInfo 'docker'

```

```text

FilesCount   : 3252590

FoldersCount : 183569

ItemsCount   : 3436159

PackageType  : Docker

Percentage   : 84.55%

RepoKey      : docker

RepoType     : LOCAL

UsedSpace    : 54.92 TB

```