首页　>　文章列表　>　"Docker系统占用空间查询命令" 与 "Docker API端点/system/df"

"Docker系统占用空间查询命令" 与 "Docker API端点/system/df"

465 2024-02-18

问题内容

我正在用 Go 编写一个程序，以从我的 docker 主机获取以 GB 为单位的总磁盘使用情况。为此，我使用 go lib 中的 func DiskUsage() ：

https://pkg.go.dev/github.com/docker/docker/client#Client.DiskUsage。

查看代码，该函数正在调用 docker api 端点 /system/df：

https://docs.docker.com/engine/api/v1.43/#tag/System/operation/SystemDataUsage

但是，当我使用此库与使用命令 docker system df 计算 GB 时，我注意到一个奇怪的行为：

docker系统df输出：

$ docker system df
TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          223       4         21.02GB   20.7GB (98%)
Containers      6         0         0B        0B
Local Volumes   13        1         536.4MB   340.4MB (63%)
Build Cache     954       0         13.51GB   13.51GB

My Go 应用程序输出：

$ go run ./cmd/main.go
Images: TOTAL (223), 17GB
Build Cache: TOTAL (954), 29GB

正如您所看到的，两个输出之间存在差异。 我需要帮助来了解我从 /system/df 端点获取数据的计算是否有问题。谢谢:)

Go应用程序：

package main

import (
    "context"
    "fmt"

    "github.com/docker/docker/api/types"
    "github.com/docker/docker/client"
)

func main() {
    cli, err := client.NewClientWithOpts(client.FromEnv)
    if err != nil {
        panic(err)
    }

    diskUsg, err := cli.DiskUsage(context.Background(), types.DiskUsageOptions{})
    if err != nil {
        panic(err)
    }
    b := float64(0)
    for _, ch := range diskUsg.BuildCache {
        b = b + float64(ch.Size)
    }

    b2 := float64(0)
    for _, ch := range diskUsg.Images {
        if ch.Size > ch.SharedSize {
            b2 = b2 + (float64(ch.Size) - float64(ch.SharedSize))
            continue
        }
        b2 = b2 + (float64(ch.SharedSize) - float64(ch.Size))
    }

    fmt.Printf("Images: TOTAL (%d), %2.fGBn", len(diskUsg.Images), float64(b2)/(1<<30))
    fmt.Printf("Build Cache: TOTAL (%d), %2.fGBn", len(diskUsg.BuildCache), float64(b)/(1<<30))
}

正确答案

基于Docker源代码：

system df 命令：https:/ /github.com/docker/cli/blob/v24.0.5/cli/command/system/df.go
输出格式：https:// github.com/docker/cli/blob/v24.0.5/cli/command/formatter/disk_usage.go

您应该能够使用以下代码准确重现 docker 系统 df 所做的事情：

go.mod

module 76982562-docker-system-df-vs-system-df-docker-api-endpoint

go 1.21.0

require (
    github.com/docker/cli v24.0.5+incompatible
    github.com/docker/docker v24.0.5+incompatible
)

main.go

package main

import (
    "context"
    "fmt"
    "os"

    "github.com/docker/cli/cli/command/formatter"
    "github.com/docker/docker/api/types"
    "github.com/docker/docker/client"
    "github.com/docker/go-units"
)

func main() {
    cli, err := client.NewClientWithOpts(client.FromEnv)
    if err != nil {
        panic(err)
    }

    diskUsage, err := cli.DiskUsage(context.Background(), types.DiskUsageOptions{})
    if err != nil {
        panic(err)
    }

    var bsz int64
    for _, bc := range diskUsage.BuildCache {
        if !bc.Shared {
            bsz += bc.Size
        }
    }

    fmt.Printf("Images: TOTAL (%d), %sn", len(diskUsage.Images), units.HumanSize(float64(diskUsage.LayersSize)))
    fmt.Printf("Build Cache: TOTAL (%d), %sn", len(diskUsage.BuildCache), units.HumanSize(float64(bsz)))
}