akka/akka-core

Perhaps recommend MaxRAMFraction in docs around deployment/docker sections?

Open

#23,499 opened on Aug 9, 2017

View on GitHub
 (4 comments) (0 reactions) (0 assignees)Scala (3,547 forks)batch import
1 - triagedhelp wantedt:docs

Repository metrics

Stars
 (13,277 stars)
PR merge metrics
 (Avg merge 8d 19h) (10 merged PRs in 30d)

Description

A new JVM option has become available recently (in JDK8 too): -J-XX:MaxRAMFraction=1 which allows the JVM be aware of limits set by cgroups onto memory.

A good combo of options when running Java in containers / cgroups nowadays is: https://twitter.com/analytically/status/894592422382063616

Could be a good hint to provide to our users in docs around how to deploy things. If someone experienced with containers from the community would like to pick this up that'd be lovely so the wording is right etc :)

Contributor guide

Research direction
Locate the Docker deployment section in the documentation and add a note recommending the use of XX:MaxRAMFraction=1 for cgroup memory awareness.
Tech stack
scalajava
Domain
backenddocumentationdevops
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
1
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
DockerJVM
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
85