https://github.com/anamba/docker-amber

Docker image for Crystal + Amber dev environment
https://github.com/anamba/docker-amber

amber crystal crystal-amber-dev crystal-lang docker-amber docker-image

Last synced: 8 months ago
JSON representation

Docker image for Crystal + Amber dev environment

• Host: GitHub
• URL: https://github.com/anamba/docker-amber
• Owner: anamba
• License: mit
• Created: 2018-11-27T00:07:13.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2020-12-01T00:11:10.000Z (over 5 years ago)
• Last Synced: 2025-03-23T17:49:13.047Z (about 1 year ago)
• Topics: amber, crystal, crystal-amber-dev, crystal-lang, docker-amber, docker-image
• Language: Dockerfile
• Homepage:
• Size: 11.7 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# docker-amber - Docker image for Amber development

[![Version](https://img.shields.io/github/tag/anamba/docker-amber.svg?maxAge=360)](https://github.com/anamba/docker-amber/releases/latest)

[![License](https://img.shields.io/github/license/anamba/docker-amber.svg)](https://github.com/anamba/docker-amber/blob/master/LICENSE)

[![Amber Framework](https://img.shields.io/badge/works_with-amber_framework-orange.svg)](https://amberframework.org)

Docker Hub: [anamba/crystal-amber-dev](https://hub.docker.com/r/anamba/crystal-amber-dev/)

Based on Phusion's excellent, developer-friendly [baseimage-docker](https://github.com/phusion/baseimage-docker) image. Now based on Ubuntu 20.04 LTS Focal.

If this image becomes out of date due to a new Amber or Crystal release, please open an issue.

## Contents

Includes:

* Crystal 0.35.1

* Amber v0.35.0

* guardian

* Node 14

Working dir is `/home/app/myapp` (user is `app`). Default port is 3000.

## Versioning

* Docker tags track Amber minor versions.

* Crystal version is selected for compatibility with Amber version.

* `latest` may not necessarily have a corresponding version tag.

## How to use

Example `docker-compose.yml`:

```yaml

version: '3'

services:

  web:

    image: anamba/crystal-amber-dev:0.35

    ports:

      - '3000:3000'  # <-- change the first number to set your local port

    volumes:

      - ./:/home/app/myapp:delegated  # NOTE: :delegated is a Docker for Mac feature

      - /home/app/myapp/node_modules  # keep node_modules off your local filesystem

    environment:

      AMBER_ENV: development

      PORT: 3000

  db:

    image: mariadb:10.4

    volumes:

      - /var/lib/mysql

    environment:

      MYSQL_ALLOW_EMPTY_PASSWORD: 1

```

From there, you can run `docker-compose up` to start the containers, then, in a separate terminal:

```bash

docker-compose exec -u app web amber watch   # run amber watch

docker-compose exec -u app web guardian      # run guardian

docker-compose exec -u app web crystal spec  # run crystal spec

docker-compose exec -u app web bash          # get a user shell

docker-compose exec web bash                 # get a root shell

```

You get the idea. You'll want to create aliases or simple shell scripts to save yourself some typing.

## Development

(notes for myself)

```

docker build --no-cache -t anamba/crystal-amber-dev:latest .

docker tag anamba/crystal-amber-dev:latest anamba/crystal-amber-dev:0.35.1

docker tag anamba/crystal-amber-dev:latest anamba/crystal-amber-dev:0.35

docker push anamba/crystal-amber-dev

```