public.readme.md

Cargo Rocket Docker

Automate tool sub-command to create a docker image for Rocket Project and build/publish them using Alpine OS.

References

• https://crates.io/crates/cargo-rocket-docker
• https://github.com/Gary-Ascuy/cargo-rocket-docker
• https://github.com/Gary-Ascuy/rust-rest-api
• https://hub.docker.com/repository/docker/garyascuy/cargo-rocket-example

Docker Image - Tested in MachOS

garyascuy/cargo-rocket-example:1.0.0
OS/ARCH: linux/amd64 
SIZE: 4.31 MB # WOOOOOOOOWWW ~5Mb
LAST PUSHED: 12 minutes ago by garyascuy

Setup

• Rust Nightly Version
• Docker Latest

$ cargo install cargo-rocket-docker

To upgrade:

$ cargo install --force cargo-rocket-docker

Usage

Add following section into Cargo.toml file

[docker]
name = "app-bin-name"
version = "0.1.0"
maintainer = "Team Name <[email protected]>"
temp_folder = "./.tmp_docker"
tag = "garyascuy/cargo-rocket-example"

Build Docker Images

$ cargo docker --build

Push Docker Images

$ cargo docker --push

All-In-One Command? Type following command:

$ cargo docker --build --push --keep-temporary-files

All-In-One Command still long? Here more alternatives:

$ cargo docker --all
$ cargo docker -a
$ cargo docker -bpk # [B]uild, [P]ush, [K] Keep Docker Files

Do you need some custom? Create files and maintaing by yourself ಠ_ಠ:

$ cargo docker --eject

I don't understand? Learn by Example:

Rust Rest API Basic API with Rocket in Rust

There's a lot more you can do! Here's a copy of the help:

USAGE:
    cargo docker [FLAGS]

FLAGS:
    -a, --all                     build and publish docker images
    -b, --build                   build docker images
    -e, --eject                   eject Dockerfile and .dockerignofe files
    -h, --help                    Prints help information
    -k, --keep-temporary-files    Keep temporary files after build execution
    -p, --push                    publish docker images
    -V, --version                 Prints version information

Config Properties

Here Full Example && Custom Tags && Alpine Packages

[docker]
name = "app-bin-name"
version = "0.1.0"
maintainer = "Team Name <[email protected]>"
temp_folder = "./.tmp_docker"
tag = "garyascuy/cargo-rocket-example"
custom_tags = [
    "registry.gitlab.com/garyascuy:latest",
    "registry.gitlab.com/garyascuy:1.0.0",
]

[docker.packages]
build = "acf-openssl"
image = "imagemagick second-pkg other-pkg"

Descriptions

# Cargo Docker Settings
[docker]
# docker will copy bin from target/release/{app-bin-name}
name = "app-bin-name" 
# Docker image version
version = "1.0.0"     
# Responsible for image
maintainer = "Team Name <[email protected]>" 
# Docker tag base, it will create tho images:
# account/back:{version} and account/back:latest
tag = "account/back" 

# docker build will use these spesific tags to create the images and publish
custom_tags = [
    "garyascuy/server:1.0.0",
    "garyascuy/server:latest",
]

# Optional install extra packages in Alpine OS
[docker.packages]
# apk add acf-openssl in build image, development dependencies
build = "acf-openssl"
# add packages in final image, production dependencies
image = "imagemagick second-pkg other-pkg"

About

Created by Gary Ascuy and Follow me in LinkedIn or GitHub if you want :P.