README
¶
Asgard
Asgard is an implementation of artifacts repository in golang. Decision to implement new tiny repo come to me when i realized that nexus requires 4gb RAM machine at minimum. Check the Nexus memory requrements. That is too much, especially when you need it only for small personal projects. This project gives you minimal, but complete nexus functionality, with ability to save artifacts on filesystem or to s3 and basic auth. For most of usecases that is more than enought.
How to build it ?
Make sure to install golang, set all env variables etc. Clone project to your go-workspace. Cd to the project folder and run:
make build
And it will compile app.
Run:
make run
And it will run app locally on port 8080 by default.
How to configure it ?
Create config.yml in your ${HOME} directory or in the same directory where you run binary.
For s3:
---
http:
addr: ":443"
username: "myuser"
password: "mypassword"
https: true
crt: "/certs/domain.crt"
key: "/certs/domain.key"
storage:
type: "s3"
bucket_name: "asgardtest"
access_key: "*******************"
secret_key: "**************************************"
And for file system:
---
http:
addr: ":8080"
username: "myuser"
password: "mypassword"
storage:
type: "fs"
base_dir: "/applications"
How to use it ?
Get / Download one specific file
# raw content
curl --user myuser:mypassword localhost:8080/dir/foo.json
curl --user myuser:mypassword localhost:8080/dir/
# file download
curl --user myuser:mypassword localhost:8080/dir/foo.json -o foo.json
# or
wget --user myuser --password mypassword localhost:8080/dir/foo.json
Files in this directory will be listed if path refers to a directory.
Upload
curl --XPOST --user myuser:mypassword --upload-file foo.json localhost:8080/dir/foo.json
Copy
curl --XPUT --user myuser:mypassword -d "{\"dist\":\"newdir\/foo.json\", \"recursive\": false}" localhost:8080/dir/foo.json
curl --XPUT --user myuser:mypassword -d "{\"dist\":\"newdir\/\", \"recursive\": true}" localhost:8080/dir/
Delete
curl --XDELETE --user myuser:mypassword localhost:8080/dir/foo.json
curl --XDELETE --user myuser:mypassword localhost:8080/dir/
Directories