1
1
Fork 0
mirror of https://github.com/goreleaser/nfpm synced 2024-05-10 04:26:19 +02:00
nfpm/README.md

61 lines
3.1 KiB
Markdown
Raw Normal View History

2018-02-18 23:32:16 +01:00
<p align="center">
<img alt="GoReleaser Logo" src="https://avatars2.githubusercontent.com/u/24697112?v=3&s=200" height="140" />
<h3 align="center">NFPM</h3>
<p align="center">NFPM is Not FPM - a simple deb and rpm packager written in Go.</p>
<p align="center">
<a href="https://github.com/goreleaser/nfpm/releases/latest"><img alt="Release" src="https://img.shields.io/github/release/goreleaser/nfpm.svg?style=flat-square"></a>
<a href="/LICENSE.md"><img alt="Software License" src="https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square"></a>
<a href="https://travis-ci.org/goreleaser/nfpm"><img alt="Travis" src="https://img.shields.io/travis/goreleaser/nfpm/master.svg?style=flat-square"></a>
<a href="https://codecov.io/gh/goreleaser/nfpm"><img alt="Codecov branch" src="https://img.shields.io/codecov/c/github/goreleaser/nfpm/master.svg?style=flat-square"></a>
<a href="https://goreportcard.com/report/github.com/goreleaser/nfpm"><img alt="Go Report Card" src="https://goreportcard.com/badge/github.com/goreleaser/nfpm?style=flat-square"></a>
<a href="http://godoc.org/github.com/goreleaser/nfpm"><img alt="Go Doc" src="https://img.shields.io/badge/godoc-reference-blue.svg?style=flat-square"></a>
<a href="https://saythanks.io/to/caarlos0"><img alt="SayThanks.io" src="https://img.shields.io/badge/SayThanks.io-%E2%98%BC-1EAEDB.svg?style=flat-square"></a>
<a href="https://github.com/goreleaser"><img alt="Powered By: GoReleaser" src="https://img.shields.io/badge/powered%20by-goreleaser-green.svg?style=flat-square"></a>
</p>
</p>
## Goals
2018-02-06 03:32:49 +01:00
2018-02-17 23:04:34 +01:00
* be simple to use
* provide packaging for the most common linux packaging systems (at very least deb and rpm)
* be distributed as a single binary
* reproducible results
* depend on the fewer external things as possible (namely `rpmbuild`)
* generate packages based on yaml files (maybe also json and toml?)
* be possible to use it as a lib in other go projects (namely goreleaser itself)
2018-02-18 23:32:16 +01:00
## Usage
2018-02-17 23:04:34 +01:00
The first steps are to run `nfpm init` to initialize a config file and edit
the generated file according to your needs:
2018-02-17 23:13:42 +01:00
![nfpm init](https://user-images.githubusercontent.com/245435/36346101-f81cdcec-141e-11e8-8afc-a5eb93b7d510.png)
2018-02-17 23:04:34 +01:00
The next step is to run `nfpm pkg --target mypkg.deb`.
NFPM will guess which packager to use based on the target file extension.
2018-02-17 23:13:42 +01:00
![nfpm pkg](https://user-images.githubusercontent.com/245435/36346100-eaaf24c0-141e-11e8-8345-100f4d3ed02d.png)
2018-02-17 23:04:34 +01:00
And that's it!
2018-02-06 03:32:49 +01:00
2018-02-18 23:32:16 +01:00
## Status
2018-02-06 03:32:49 +01:00
2018-02-17 23:04:34 +01:00
* both deb and rpm packaging are working but there are some missing features;
* we need a suite of acceptance tests to make sure everything works.
2018-02-18 23:32:16 +01:00
## Donate
Donations are very much appreciated! You can donate/sponsor on the main
[goreleaser opencollective](https://opencollective.com/goreleaser)! It's
easy and will surely help the developers at least buy some :coffee: or :beer:!
## Stargazers over time
[![goreleaser/nfpm stargazers over time](https://starcharts.herokuapp.com/goreleaser/nfpm.svg)](https://starcharts.herokuapp.com/goreleaser/nfpm)
---
Would you like to fix something in the documentation? Feel free to open an [issue](https://github.com/goreleaser/nfpm/issues).