48 lines
1.6 KiB
Markdown
48 lines
1.6 KiB
Markdown
# automemlimit
|
|
|
|
[](https://pkg.go.dev/github.com/KimMachineGun/automemlimit)
|
|
[](https://goreportcard.com/report/github.com/KimMachineGun/automemlimit)
|
|
[](https://github.com/KimMachineGun/automemlimit/actions/workflows/test.yml)
|
|
|
|
Automatically set `GOMEMLIMIT` to match Linux [cgroups(7)](https://man7.org/linux/man-pages/man7/cgroups.7.html) memory limit.
|
|
|
|
See more details about `GOMEMLIMIT` [here](https://tip.golang.org/doc/gc-guide#Memory_limit).
|
|
|
|
## Installation
|
|
|
|
```shell
|
|
go get github.com/KimMachineGun/automemlimit@latest
|
|
```
|
|
|
|
## Usage
|
|
|
|
```go
|
|
package main
|
|
|
|
// By default, it sets `GOMEMLIMIT` to 90% of cgroup's memory limit.
|
|
// You can find more details of its behavior from the doc comment of memlimit.SetGoMemLimitWithEnv.
|
|
import _ "github.com/KimMachineGun/automemlimit"
|
|
```
|
|
|
|
or
|
|
|
|
```go
|
|
package main
|
|
|
|
import "github.com/KimMachineGun/automemlimit/memlimit"
|
|
|
|
func init() {
|
|
memlimit.SetGoMemLimitWithOpts(
|
|
memlimit.WithRatio(0.9),
|
|
memlimit.WithEnv(),
|
|
memlimit.WithProvider(memlimit.FromCgroup),
|
|
)
|
|
memlimit.SetGoMemLimitWithEnv()
|
|
memlimit.SetGoMemLimit(0.9)
|
|
memlimit.SetGoMemLimitWithProvider(memlimit.Limit(1024*1024), 0.9)
|
|
memlimit.SetGoMemLimitWithProvider(memlimit.FromCgroup, 0.9)
|
|
memlimit.SetGoMemLimitWithProvider(memlimit.FromCgroupV1, 0.9)
|
|
memlimit.SetGoMemLimitWithProvider(memlimit.FromCgroupV2, 0.9)
|
|
}
|
|
```
|