v0.27.0: Release Notes

v0.27.0 was released on October 5. This time we are releasing management Rest API. The API allows to manage Artipie repositories, storages and users. API is self-documented with Swagger interface.

We implemented Rest API using Vert.x web framework and OpenAPI specification v3.0.0. Endpoints can be (by user’s choose) protected with SSL, authentication is implemented with JWT-tokens. Here is simple and short instructions, how to run latest Artipie Docker image and check new Rest API:

First, make sure you have already installed Docker Engine. Then, open command line and instruct Docker Engine to run Artipie container:

docker run -it -p 8080:8080 -p 8086:8086 artipie/artipie:latest

Artipie image generates default configuration, prints a list of running repositories, test credentials and a link to the Swagger documentation to console. To check existing repositories using Artipie Rest API:

go to Swagger documentation page http://localhost:8086/api/index-org.html, choose “Auth token” in “Select a definition” list,
generate and copy authentication token for default user artipie/artipie,
switch to “Repositories” definition, press “Authorize” button and paste the token
then perform GET /api/v1/repository/list request. Response should be a json list with three default repositories:
```
[
"artipie/my-bin",
"artipie/my-docker",
"artipie/my-maven"
]
```
To learn more about Rest API, check Wiki documentation.

At the beginning of September another article about Artipie was published in Russian IT resource, check it here. Habr is the largest and the most well known Russian IT resource.

If you have any question, suggestion or notes, please, do not hesitate to comment this blog post or contact us in Telegram.