mirror of https://github.com/docker/docs.git
Merge branch 'master' of github.com:docker/toolbox
This commit is contained in:
commit
5eea30fe7c
|
|
@ -6,7 +6,7 @@ Docker Toolbox  |
|
| | Mac | Windows | Desktop Linux (Help Wanted) |
|
||||||
|------------------------|--------|-------------|--------------------------------|
|
|------------------------|--------|-------------|--------------------------------|
|
||||||
| Docker Client / Engine | Client | Client | Engine |
|
| Docker Client / Engine | Client | Client | Engine |
|
||||||
| Docker Machine | Yes | Yes | Yes |
|
| Docker Machine | Yes | Yes | Yes |
|
||||||
|
|
|
||||||
|
|
@ -5,8 +5,3 @@ Installation [instructions](https://docs.docker.com/mac/started/) available on t
|
||||||
##How to build
|
##How to build
|
||||||
|
|
||||||
Running `make` will produce a `Docker.pkg` installer.
|
Running `make` will produce a `Docker.pkg` installer.
|
||||||
|
|
||||||
##License
|
|
||||||
Docker Toolbox code is licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/docker/toolbox/blob/master/LICENSE) for the full license text.
|
|
||||||
|
|
||||||
Docker Toolbox Logo and all other related Docker artwork © Docker, Inc. 2015. All rights reserved; not licensed for third party use.
|
|
||||||
|
|
|
||||||
|
|
@ -1,47 +0,0 @@
|
||||||
# Preparing development environment (for maintainers)
|
|
||||||
|
|
||||||
1. Install Inno Setup 5 non-unicode: http://www.jrsoftware.org/isdl.php (`isetup-5.x.x-unicode.exe`).
|
|
||||||
|
|
||||||
2. Install `kSignCMD`: http://codesigning.ksoftware.net/ (click "Download kSign"
|
|
||||||
and then "FREE DOWNLOAD" or "Click Here to Download kSign", which will likely be
|
|
||||||
a link to http://cdn1.ksoftware.net/ksign_installer.exe)
|
|
||||||
|
|
||||||
3. Install the `docker-code-signing.pfx` certificate somewhere (the instructions
|
|
||||||
below assume `Z:\sven\src\docker\windows-installer\docker-code-signing.pfx`);
|
|
||||||
you will need the password (`d_get_from_core` below).
|
|
||||||
|
|
||||||
4. Open `Toolbox.iss` in the Inno Setup Compiler. It has a few constants at
|
|
||||||
the top that are important to make note of (especially `MyAppVersion` and the
|
|
||||||
path variables `dockerCli`, `dockerMachineCli`, `kitematicSetup`, `b2dIso`, `msysGit`, `virtualBoxMsi`, and `virtualBoxCommon`).
|
|
||||||
|
|
||||||
5. Launch **Inno Setup Compiler** by opening `Toolbox.iss` and add code signing
|
|
||||||
by applying the following steps:
|
|
||||||
|
|
||||||
- Click "Tools" --> "Configure Sign Tools" > "Add"
|
|
||||||
- "Name of the Sign Tool:" `ksign`
|
|
||||||
- "Command of the Sign Tool:" `"C:\Program Files (x86)\kSign\kSignCMD.exe" /f Z:\sven\src\docker\windows-installer\docker-code-signing.pfx /p d_get_from_core $p`
|
|
||||||
|
|
||||||
# Releasing a new version
|
|
||||||
|
|
||||||
Update the versions of the dependencies in `bundle.sh`.
|
|
||||||
|
|
||||||
Update `#define MyAppVersion` line in `Toolbox.iss`.
|
|
||||||
|
|
||||||
# Downloading bundle dependencies
|
|
||||||
|
|
||||||
Open a git bash window in this directory and run script:
|
|
||||||
|
|
||||||
./bundle.sh
|
|
||||||
|
|
||||||
This should be downloading dependencies with their correct versions to `bundle\`
|
|
||||||
folder where the Inno Setup Compiler can pick up from.
|
|
||||||
|
|
||||||
# Compiling the installer
|
|
||||||
|
|
||||||
After configuring, open `Toolbox.iss` with Inno Setup Compiler and hit
|
|
||||||
**'Build'**. The results will be in the `Output` folder.
|
|
||||||
|
|
||||||
This can be done through commandline as welll. Launch a cmd.exe shell from this
|
|
||||||
directory and run:
|
|
||||||
|
|
||||||
"c:\Program Files (x86)\Inno Setup 5\ISCC.exe" Toolbox.iss
|
|
||||||
|
|
@ -1,20 +1,47 @@
|
||||||
# Docker Toolbox for Windows
|
# Building the Windows Toolbox
|
||||||
|
|
||||||
Installation [instructions](http://docs.docker.com/windows/started/) available on the Docker documentation site.
|
1. Install Inno Setup 5 non-unicode: http://www.jrsoftware.org/isdl.php (`isetup-5.x.x-unicode.exe`).
|
||||||
|
|
||||||
## Why Inno Setup?
|
2. Install `kSignCMD`: http://codesigning.ksoftware.net/ (click "Download kSign"
|
||||||
|
and then "FREE DOWNLOAD" or "Click Here to Download kSign", which will likely be
|
||||||
|
a link to http://cdn1.ksoftware.net/ksign_installer.exe)
|
||||||
|
|
||||||
I've chosen to make a simple installer using [Inno Setup](http://www.jrsoftware.org/)
|
3. Install the `docker-code-signing.pfx` certificate somewhere (the instructions
|
||||||
because that is what the [msysGit](http://git-scm.com/) installer is built with.
|
below assume `Z:\sven\src\docker\windows-installer\docker-code-signing.pfx`);
|
||||||
|
you will need the password (`d_get_from_core` below).
|
||||||
|
|
||||||
(It also happens that I've used Inno Setup before, so I can make something faster.)
|
4. Open `Toolbox.iss` in the Inno Setup Compiler. It has a few constants at
|
||||||
|
the top that are important to make note of (especially `MyAppVersion` and the
|
||||||
|
path variables `dockerCli`, `dockerMachineCli`, `kitematicSetup`, `b2dIso`, `msysGit`, `virtualBoxMsi`, and `virtualBoxCommon`).
|
||||||
|
|
||||||
## Maintenance
|
5. Launch **Inno Setup Compiler** by opening `Toolbox.iss` and add code signing
|
||||||
|
by applying the following steps:
|
||||||
|
|
||||||
See `MAINTENANCE.md` for instructions on how to update, bundle and compile the
|
- Click "Tools" --> "Configure Sign Tools" > "Add"
|
||||||
Docker Toolbox Windows Installer.
|
- "Name of the Sign Tool:" `ksign`
|
||||||
|
- "Command of the Sign Tool:" `"C:\Program Files (x86)\kSign\kSignCMD.exe" /f Z:\sven\src\docker\toolbox\docker-code-signing.pfx /p d_get_from_core $p`
|
||||||
|
|
||||||
## License
|
# Releasing a new version
|
||||||
Docker Toolbox code is licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/docker/toolbox/blob/master/LICENSE) for the full license text.
|
|
||||||
|
|
||||||
Docker Toolbox Logo and all other related Docker artwork © Docker, Inc. 2015. All rights reserved; not licensed for third party use.
|
Update the versions of the dependencies in `bundle.sh`.
|
||||||
|
|
||||||
|
Update `#define MyAppVersion` line in `Toolbox.iss`.
|
||||||
|
|
||||||
|
# Downloading bundle dependencies
|
||||||
|
|
||||||
|
Open a git bash window in this directory and run script:
|
||||||
|
|
||||||
|
./bundle.sh
|
||||||
|
|
||||||
|
This should be downloading dependencies with their correct versions to `bundle\`
|
||||||
|
folder where the Inno Setup Compiler can pick up from.
|
||||||
|
|
||||||
|
# Compiling the installer
|
||||||
|
|
||||||
|
After configuring, open `Toolbox.iss` with Inno Setup Compiler and hit
|
||||||
|
**'Build'**. The results will be in the `Output` folder.
|
||||||
|
|
||||||
|
This can be done through commandline as welll. Launch a cmd.exe shell from this
|
||||||
|
directory and run:
|
||||||
|
|
||||||
|
"c:\Program Files (x86)\Inno Setup 5\ISCC.exe" Toolbox.iss
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue