Skip to content

mworksio/asgard

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Go Report Card

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/

License

GPL

About

Minimal artifact repository.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 89.8%
  • Shell 6.5%
  • Dockerfile 2.7%
  • Makefile 1.0%