southsmalltalks

Build your application from the Pharo-minimal image.

Create a deployable image just loading the application on the minimal image and disabling the command line handlers.

Tools necessaries for this approach

• Dependency Analyser
• Minimal Image
• Metacello
• ConfigurationOf or BaselineOf is needed
• ConfigurationCommandLineHandler
• Smalltalk scripts

  The minimal image process

• [x] Create an entry point object
• [x] Use the Dependency Analyser for detect and add the dependencies to BaselineOf or ConfigurationOf
• [x] Create a BaselineOf or ConfigurationOf
• [x] Load your application on the minimal image
• [ ] Disable code loading
• [x] Remove the changes file
• [x] Remove the sources file

  Registering the Entry Point Object

MyApplicationEntryPoint class>>#initialize
    SessionManager default
            register: (ClassSessionHandler forClassNamed: 
         self name)
            inCategory: SessionManager default 
                      userCategory

StartUp and ShutDown

MyApplicationEntryPoint class>>startUp: arg1
    MyApplicationManager instance startAlgorithm


MyApplicationEntryPoint class>>shutDown: arg1
    MyApplicationManager instance stopAlgorithm

If We get the minimal image and use the VM that we was used to development process wont work

(linux)

curl get.pharo.org/61-minimal
./pharo Pharo-minimal.image
This interpreter (vers. 68021) cannot read image file (vers. 6521).
Press CR to quit...

### Get the minimal image and use the 32 bits VM

 curl get.pharo.org/vm61 | bash
curl get.pharo.org/61-minimal | bash
./pharo Pharo-minimal.image eval “2+2”
4

### Order your ideas # Your aplication environment

• Create a development directory
• Create a exe-factory directory
• Create the deploy directory
• Save the minimal image in the exe-factory directory and in the deploy directory
• Save the 32 bits VM exe-factory directory and in the deploy directory

• Proof that all works .

• development
  • myApplication.image
  • myApplication.changes
  • sources
  • vm
• exe-factory
  • myApplication.image
  • myApplication.changes
  • sources
  • scripts_to_load_code
• deployment
  • myApplication.image
  • vm

Load your application in the minimal image

The next script doesn’t work with GitHub and Filetree repositories. With SmalltalkHub works.

./pharo Pharo-minimal.image config \ repositoryOfMyApplication\ BaselineOfMyApplication\ --install=baseline

If you try do the same thing with PharoConsole in Windows but doesn’t work.

For Windows you can load your application using Smalltalks's scripts
 PharoConsole.exe Pharo-minimal.image loadMyApplication.st

Script Example

Metacello new
baseline: 'MyApplication';
filetreeDirectory:'pathToMyApplication';
load.
SmalltalkImage current   saveImageInFileNamed:'myApp.image'.
SmalltalkImage current snapshot: true andQuit: true

Metacello new
baseline:'ToDoApplication';
repository: 'github://despotadesdibujau/seaside-todo-application:master';
load.
SmalltalkImage current   saveImageInFileNamed:'myApp.image'.
SmalltalkImage current snapshot: true andQuit: true

This should work but some dependencies of filetree aren’t loaded in the minimal image, so you need load these dependencies. When you was loaded these dependencies execute Smalltalk recompile and save the image. Rename the image and try to load your application.

Dependencies of filetree in order of dependency (from botton to top)

• STON-Core
• MonticelloFileTree-Core
• Metacello-GitBasedRepository
• Metacello-GitHub

With this script you can prepare the minimal image to load your application from github and filetree (proven) ### Example for Windows script-to-prepare-minimal-image.st

 PharoConsole.exe Pharo-minimal.image script-to-prepare-minimal-image.st
PharoConsole.exe minimal-ready.image loadMyApplication.st
PharoConsole.exe myApplication.image

So far My idea was to prepare a minimal image with every tool for load code:Monticello,Metacello suporting all types of repositories (filetree,github,gitbucket, gitlab,…etc),…etc.

But luckily Pavel Krivanek said

“In Pharo 7 most of them are already part of the the minimal (Metacello) image.”

### Disable the reads to sources and changes Wiht this script you can disable the calls to changes and sources

Full example (proven in Ubuntu 14.04)

Firts of all:

• create a directory for the application
• go to directory just created and create a file called loadMetacello.st and paste this code
• create a file called loadApplication.st and paste this code
• create a file called disableChangesAndSources.st and paste this code
• create a file called welcome.st and paste this code:

  2+2
  

• and then paste the next lines in a terminal

  curl get.pharo.org/vm61 | bash \
  && curl get.pharo.org/61-minimal | bash \
  && ./pharo Pharo.image loadMetacello.st \
  && ./pharo minimal-ready.image loadApplication.st \
  && ./pharo todoApplication.image disableChangesAndSources.st \
  && rm *.changes \
  && rm pharo-vm/lib/pharo/5.0-201707201942/PharoV60.sources \
  && ./pharo todoApplication.image welcome.st
  

  In the browser go to http://localhost:8080/examples/todo If everithing is ok you should to see a todoApplication of Seaside’s examples, if not send me an email despotadesdibujau@gmail.com

### Next and last step:

• Unload the posibilities to change the application in production