先日公開されたGoの公式ブログ「Container-aware GOMAXPROCS」は、コンテナでGoを動かす開発者にとって良いアップデートの情報をご紹介をさせていただきます。
「docker run --cpus="2.0"でCPUを制限しているのに、想定通りじゃなさそうだな…🤔」そんな経験はありませんか？
Go 1.25から、そのような課題がGoランタイム自身によって解決されます。この記事では、公式ブログの内容を基に、Dockerを触る開発者にとって具体的に何がどう変わるのかを解説します。
docker run --cpusもあるけど不十分だった件
Dockerでアプリケーションを動かす際、--cpusオプションでコンテナが使用できるCPUリソースを制限することができます。
しかし、従来のGoランタイムは、このDockerによる制限を認識できませんでした。Goはコンテナの外側、つまりホストマシン全体のCPUコア数を見てGOMAXPROCS（並列実行スレッド数）を判断していました。
例えば、8コアのPC上で、--cpus="2.0"オプションを付けてGoアプリのコンテナを起動した状況を考えてみましょう。
Goアプリは8コアあると信じて8スレッドを動かそうとしますが、Dockerからは2コア分のCPU時間しか与えられていません。このギャップにより、OSはGoアプリの処理を頻繁に中断（スロットリング）させ、結果としてパフォーマンスが大きく低下していました。
このため、私たちはこれまでENV GOMAXPROCS=2をDockerfileに書き加えるなどの手動設定が必要でした。
Go 1.25でシンプルに解決！
公式ブログで解説されている通り、Go 1.25からはGoランタイムがコンテナのCPU制限を自動で認識するようになります。これはDockerが内部で利用しているLinuxのcgroupという仕組みをGoが直接解釈できるようになったためです。直接解釈してくれるのは最高👍
これにより、開発者の作業は劇的に変化しますね！
| Go 1.24以前 | Go 1.25以降 | |
|---|---|---|
| 挙動 | ホストマシンのCPUコア数を参照 |
docker run --cpusの値を自動認識 |
| 開発者の対応 |
GOMAXPROCSの手動設定が必要 |
原則、何もしなくてよい |
| メリット | - | ・設定漏れの防止 ・Dockerfileの簡素化 ・パフォーマンスの自動最適化 |
Docker開発者にとっての具体的なメリット
1. Dockerfileとdocker runコマンドの簡素化
--cpusの値に合わせてDockerfileを書き換えたり、docker run時に-eオプションで環境変数を渡す必要がなくなります。
Before (Dockerfileの例)
# --cpus=2.0 に合わせて手動で設定する必要があった
ENV GOMAXPROCS=2
CMD ["/app"]
After (Go 1.25)
# GOMAXPROCSの設定は不要。
# `docker run --cpus`の値に応じてランタイムが自動で判断する。
CMD ["/app"]
これにより、開発環境（--cpus無制限）と本番環境（--cpus="1.0"）でイメージやコマンドを使い分ける必要がなくなり、設定ミスが減りますね
2. automaxprocsライブラリが不要に
この問題を解決するために広く使われてきたuber-go/automaxprocsというサードパーティライブラリがありましたが、Go 1.25からは標準機能として同等の機能が提供されるため、依存ライブラリを1つ減らすことができます。
3. パフォーマンスの安定化
ローカルのDockerでも、CI/CDパイプライン上のコンテナでも、常にその環境のCPUリソースに応じた最適なパフォーマンスが引き出せます。CPUスロットリングによる意図しない性能劣化を防ぎ、アプリケーションの動作を安定させることができます。
まとめ
Go1.25 GOMAXPROCSでコンテナ上のCPU管理が楽できる。
Dockerfileから GOMAXPROCS 設定を削除可能になる。
このような自動制御してくれる機能がアプリケーションの運用視点で喜ばしいことだと思います！！
参考情報
Discussion