Documentation
  • Introduction
  • Why Ampersand?
    • The Business Rules Manifesto and Ampersand
  • Tutorial
    • Example system: Enrollment
    • Conceptual Model: Enrollment
    • Your tool: RAP4
    • Making your first Ampersand script
  • Reactive programming
  • The language Ampersand
    • How to read syntax statements
    • Truth
    • Atoms
    • The CONCEPT statement
    • The RELATION statement
    • The MEANING statement
    • The PURPOSE statement
    • The CLASSIFY statement
    • The RULE statement
    • Terms
      • Semantics
      • Semantics in logic
        • Primitive terms
        • Boolean operators
        • Relational operators
        • Residual operators
      • Semantics in natural language
        • Primitive terms in natural language
        • Boolean operators in natural language
        • Relational operators in natural language
        • Residual operators in natural language
      • Semantics in sets
        • Primitive terms in set theory
        • Boolean operators in set theory
        • Relational operators in set theory
      • Semantics of terms, defined algebraically
        • Boolean operators in algebra
        • Relational operators in algebra
      • Semantics visualized
        • Semantics of boolean operators visualized
        • Semantics of relational operators visualized
        • Semantics of residuals visualized
    • Context
    • Module
    • Best Practices
    • Syntactical Conventions
      • The CONCEPT statement
      • The RELATION statement
      • The RULE statement
      • The CONTEXT statement
      • The INCLUDE statement
      • Explanation
      • Patterns
      • Population
        • Population in spreadsheets
      • The PURPOSE statement
      • The IDENT statement
      • The TABLE statement
      • Language support
    • The INCLUDE statement
    • Patterns
    • Services
      • Example: Client
      • Example: Login
      • Syntax and meaning
      • Explanation
      • Layout of user interfaces
        • Your own widgets (HTML and CSS)
      • CRUD
    • Population
      • Population in spreadsheets
    • The ENFORCE statement
    • The IDENT statement
    • The TABLE statement
    • Language support
    • Current date
    • The Preprocessor
    • Design considerations
  • Running the Ampersand compiler
    • Configuration
    • Commands (vs. 4.0.0 and later)
    • Options (up to vs. 3.17.4)
  • Architecture of an Ampersand Application
    • Backend framework
    • Hooks
    • Extensions
      • The ExecEngine
  • Deploying your Ampersand script
    • Compiler
    • Deploy your own web application on your laptop
    • Prototype multi-stage build
    • Prototype database
  • Reusing Available Modules
    • Modules
    • Security
    • SIAM (Sessions, Identity and Access Management) Module
  • Exercises
    • Delivery
    • VOG (in Dutch)
  • Installing Ampersand
    • Deploying your Prototype
    • Installing the tools manually
  • Modeling
    • Domain Driven Design
    • Data modeling
    • Legal modeling
    • Architecture modeling
    • Metamodeling
    • Limitations of Ampersand
  • Configuring your application
  • The Excel Importer
  • Plans
    • Current State
    • NoSQL storage
    • API documentation
    • OWL and RDFS input
    • Refactor the front-end
  • Research
Powered by GitBook
On this page
Export as PDF
  1. Deploying your Ampersand script

Compiler

To use the Ampersand compiler from the command line without installing Ampersand, you can call on Docker. This page gives you the quick "how-to's" for this purpose.

PreviousDeploying your Ampersand scriptNextDeploy your own web application on your laptop

Last updated 5 years ago

To run the Ampersand compiler from any computer that runs docker, use a Docker image from our Ampersand repository on GitHub: docker.pkg.github.com/ampersandtarski/ampersand/ampersand

Make a shortcut tag to save typing:

docker tag docker.pkg.github.com/ampersandtarski/ampersand/ampersand ampersand

Different tags are available, e.g.:

  • :latest -> development branch It contains the most recent developments that have passed the automated test sets.

  • :stable -> master branche This contains the latest stable release of ampersand. Use it for the lowest risk.

  • :[branch] -> specific branch This allows you to pick a version yourself

  • :v3.17 -> specific tags/releases To use a specific previous version.

docker run -it -v "$(pwd)":/usr/local/project ampersand [OPTIONS] FILE

This alternative presumes you have docker installed on your computer and it can be found (i.e. the path is set correctly).

If you experience problems downloading from docker.pkg.github.com, you may first have to log in with an appropriate token. Generate a token and be sure to switch on all repo-rights and the read:packages-right. With that token log in:

docker login -u <GITHUB USERNAME> -p <TOKEN> docker.pkg.github.com
on github