dockerize_sidekick_plugin 0.4.0

Lets you easily generate a Docker Container for your Flutter Web App.

dockerize_sidekick_plugin

A plugin for sidekick CLIs.

Description

This plugin for sidekick wants to make it as easy as possible to deploy your flutter web app as a docker container.

Installation

Kickstart

with having docker and sidekick installed

<<your_cli>> sidekick plugins install dockerize_sidekick_plugin
<<your_cli>> docker run -b

Docker

To run this locally you need Docker installed on your machine.

The commands

Install the plugin

<<your_cli>> sidekick plugins install dockerize_sidekick_plugin

Build the Docker Image

There are multiple build commands available for this plugin. Here is a brief overview:

• <<your_cli>> docker build app: Runs a basic Flutter build web command
• <<your_cli>> docker build scripts: Runs all the required scripts to move files to the right place or hash scripts from the index.html
• <<your_cli>> docker build image: Builds the Docker image and also executes the app and scripts build commands You can choose between different environments using the --env flag. The default environment is dev. You can customize the build process in the commands/build folder.

Run the Docker Image Locally

To run the Docker image locally, use the following command:

<<your_cli>> docker run

This will run the app and make it accessible at localhost:8000.

Notice: A hot-reload is enabled, which will rerun the required build commands if you change a file. You can detach and kill the container by pressing Ctrl + C.

You can use the following flags to customize the run command:

• -b, --build-all: Executes all build commands before running the container (Recommended if you just changed something in the project)
• -build-scripts: Executes the scripts build command before running the container (Recommended if you just changed something in the server/ folder)
• --build-image: Executes the image build command before running the container (Recommended if you just changed something in the Dockerfile)
• -p, --port: Specifies the port on which the app is accessible. The build command can choose between different environments. The default environment is dev. You can change the environment with the --env flag.

Stop the container

<<your_cli>> docker stop

Deploy the docker image

Deploying the docker image depends on the environment you are deploying to. Here are the official guides for the biggest cloud providers:

• AWS
• Azure
• Google Cloud Run

Further reading

Environments

By default we are generating a very simple way of handling different environments. You can change the environments in the commands/docker/environment.dart file.

Build args

You can easily pass arguments to your docker file. To do this you can just pass the build args into the createDockerImage function in the commands/docker/build_image_command.dart file.

Script hashes

By default we are generating script hashes for each script tag in your index.html file. You can change the hashtype or disable it in the commands/docker/build_command.dart file.

CSP Rules

By default we are adding a default Set of CSP rules to the server/bin/middlewares.dart File. You can change the rules or disable them in the commands/docker/build_command.dart file. You can find more informations about CSP Rules here.

Docker Garbage Collection

We are currently collecting all dangling images and containers after the build process to keep your docker environment clean. If you dont want to have this Feature feel free to open an Issue.

Help

If you need help, you can always use the help command.

<<your_cli>> docker --help

Issues and Feedback

Feel free to open an issue or send a pull request.

License

Copyright 2022 Justin Baumann, Robin Schönau

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.