diff --git a/README.md b/README.md index 351ce40ffbfd..5ea6324fed89 100644 --- a/README.md +++ b/README.md @@ -7,51 +7,111 @@ [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/docker/cli/badge)](https://scorecard.dev/viewer/?uri=github.com/docker/cli) [![Codecov](https://img.shields.io/codecov/c/github/docker/cli?logo=codecov)](https://codecov.io/gh/docker/cli) +docker-logo + +--- + +# ๐Ÿ“Œ Table of Contents + +- [About](#about) +- [Features](#features) +- [Development](#development) + - [Build CLI from Source](#build-cli-from-source) + - [Build Binaries for All supported Platforms](#build-binaries-for-all-supported-platforms) + - [Build for a Specific Platform](#build-for-a-specific-platform) + - [Build Dynamic Binary for glibc or musl](#build-dynamic-binary-for-glibc-or-musl) + - [Run all Linting](#run-all-linting) + - [Run Test](#run-test) + - [List all the Available Targets](#list-all-the-available-targets) + - [In-container Development Environment](#in-container-development-environment) +- [Legal](#legal) +- [Community](#community) +- [Licensing](#licensing) + + +--- + ## About -This repository is the home of the Docker CLI. +The Docker CLI is the official command-line interface used to interact with the Docker Engine. It provides developers, DevOps engineers, and system administrators with a powerful tool to manage containerized applications and resources such as images, containers, networks, and volumes. + +This CLI is a key component of the Docker platform and is widely used in development environments, CI/CD pipelines, and production systems across various operating systems and architectures. + +This repository contains the source code and tooling required to build, test, and contribute to the Docker CLI. It supports cross-compilation, custom builds, and offers a developer-friendly workflow using Docker itself. + +## Features + +Some of the key features of the Docker CLI include: + +- **Container Lifecycle Management** + Create, start, stop, restart, and remove containers with simple commands. + +- **Image Management** + Build, pull, push, and inspect Docker images across local and remote registries. + +- **Multi-Platform Builds** + Cross-compile and build images for multiple platforms using `buildx`. + +- **Network and Volume Control** + Manage container networking, custom bridge networks, and persistent storage volumes. + +- **Inspect and Debug** + Use commands like `docker inspect`, `logs`, and `exec` to investigate running containers. + +- **Scriptable and CI/CD Friendly** + Seamless integration with CI/CD tools for automated testing, building, and deployment. + +- **Extensive Documentation and Plugin Support** + Well-documented CLI commands and support for extensions and custom plugins. + +- **Docker Contexts** + Easily switch between different Docker endpoints (e.g., local, remote, cloud). + +- **Secure by Design** + Actively maintained with security in mind and part of the OpenSSF Scorecard program. + ## Development `docker/cli` is developed using Docker. -Build CLI from source: +### Build CLI from source: ```shell docker buildx bake ``` -Build binaries for all supported platforms: +### Build binaries for all supported platforms: ```shell docker buildx bake cross ``` -Build for a specific platform: +### Build for a specific platform: ```shell docker buildx bake --set binary.platform=linux/arm64 ``` -Build dynamic binary for glibc or musl: +### Build dynamic binary for glibc or musl: ```shell USE_GLIBC=1 docker buildx bake dynbinary ``` -Run all linting: +### Run all linting: ```shell docker buildx bake lint shellcheck ``` -Run test: +### Run test: ```shell docker buildx bake test ``` -List all the available targets: +### List all the available targets: ```shell make help @@ -78,6 +138,20 @@ violate applicable laws. For more information, see https://www.bis.doc.gov +## Community + +We welcome contributions, feedback, and collaboration from the community! + +### Where to connect + +- [GitHub Discussions](https://github.com/docker/cli/discussions) โ€“ Ask questions, share ideas, or get help. +- [Contributing Guide](https://github.com/docker/cli/blob/master/CONTRIBUTING.md) โ€“ Learn how to contribute to the Docker CLI. +- [Docker Community Forums](https://forums.docker.com) โ€“ Join conversations with the broader Docker community. +- [Docker Community Slack](https://dockr.ly/slack) โ€“ Chat with other developers in real time. +- [Issues](https://github.com/docker/cli/issues) โ€“ Found a bug? Report it here. + +Weโ€™re excited to see what youโ€™ll build and contribute with Docker CLI! + ## Licensing docker/cli is licensed under the Apache License, Version 2.0. See