github.com/buildtool/build-tools@v0.2.29-0.20240322150259-6a1d0a553c23/www/docs/introduction.md (about)

     1  # Introduction
     2  
     3  build-tools is a set of highly opinionated tools for creating and building
     4  components/services into [docker](https://www.docker.com/) images and deploying
     5  them to [Kubernetes](https://kubernetes.io/) clusters.
     6  
     7  By following the conventions set by the tools, building and deploying applications is made simpler. It streamlines the
     8  process of building and deploying using the same commands on your local development machine and in a CI/CD pipeline.
     9  
    10  The basic usage is `build`, `push` and `deploy` (or `promote` if you are using [GitOps](config/gitops.md)). This will
    11  build a docker image of your code using your provided
    12  [Dockerfile](https://docs.docker.com/engine/reference/builder/) making it possible to customize the actual build
    13  process. The built image is then pushed to a [Docker Registry](https://docs.docker.com/registry/)
    14  of your choosing. This is of course optional, but a necessary step to be able to deploy the built image on a (non-local)
    15  Kubernetes cluster. Finally, the code is deployed to the Kubernetes cluster using the
    16  provided [descriptor files](config/k8s.md).
    17  
    18  
    19  <script id="asciicast-387073" src="https://asciinema.org/a/387073.js" id="asciicast-387073" async data-autoplay="true" data-preload="true" data-theme="solarized-dark"></script>