Breaking changes
For custom configurations (using docksal.yml
), if you are getting:
ERROR: Named volume "host_home:/.home:ro" is used in service "cli" but no declaration was found in the volumes section.
Remove host_home:/.home:ro
from docksal.yml
and do a fin up
.
New software versions
- docker v17.06.0-ce
- docker-compose v1.14.0
- docker-machine v0.12.0
- VirtualBox v5.1.22
- winpty-0.4.3-cygwin-2.8.0-ia32
- fin v1.22.0
- System and stack images updates
vhost-proxy
: docksal/vhost-proxy:1.1web
: docksal/web:2.0-apache2.2 and docksal/web:2.0-apache2.4db
: docksal/db:1.1cli
: docksal/cli:1.3-php5 and docksal/cli:1.3-php7
New Features
- Implemented a Docker healthcheck for cli
- Requires docksal/cli v1.3.0+. Falls back to waiting for 10s for the container to become ready for older versions.
- Addons (experimental)
- Ability to install and remove addons (custom commands) per project or globally from statically defined repo docksal/addons
- Prevent NFS conflicts on macOS. (#133)
DOCKSAL_NFS_PATH
can be used to override Docksal projects folder which effectively serves as NFS mount point.
- Added support for simple static site creation in
fin project create
(#177) - Added custom commands to bash autocomplete (#232)
fin sql-import --progress
--progress
displays import progress usingpv
(if installed on the host)
fin build
- support fordocker-compose build
workflow- Support for executing custom commands in
cli
instead of host- Add
#: exec_target = cli
in the header of the custom command to tell fin to execute the command withincli
viafin exec
- Add
Changes and improvements
- The VM on Mac and Windows will now use 2GB of RAM by default
- Anyone who's low on RAM (< 8GB) can use
fin vm ram 1024
to limit the VM memory to 1GB
- Anyone who's low on RAM (< 8GB) can use
- Use
nocopy
mode forproject_root
volume- This tells Docker to not merge the content of the volume with the destination directory in the container (if one is not empty)
- SSH Agent usage refactoring
- Removed dependency on the host's
$HOME
directory mount.
- Removed dependency on the host's
host_home
volume is deprecated and removed from stack files- This is a breaking change!
- See instructions above on the necessary adjustments to
docksal.yml
.
- Ability to stop at restart certain service container, e.g.
fin restart db
- Fix mysql import for large database (#279)
- Database truncation was rewritten. Now database will be dropped and re-created. Should work faster and more reliable.
- Mysql import and dump functions will properly read
MYSQL_DATABASE
environment variable (#276) - Temporary workaround for NFS issues on Mac (#265)
- Fixed the install/update process handling when Docker is already installed (#298)
- Other fixes and improvements
Documentation
- New: Extending stock images
- New: Folder aliases
- New: File sharing
- Updated: Docker for Mac, Solr, Memcached, Behat and Blackfire docs
- Updated: Troubleshooting with mysql memory edge case