Arc Fusion CLI
This is the CLI tool for running Arc Fusion on your local machine.
Changelog
You can see the changelog here. You will need to be logged into Okta and have access to Arc Learning Center (ALC).
Requirements
The following apps/commands are required for the fusion CLI to function properly:
- node - This should be the same version of Node your
FUSION_RELEASE
is using (v10 in 2.7.x and earlier, v12 in 2.8.x, and v14 in 3.0+) - npm - This should be the default version provided by node (v6 in Node 14 and earlier, v7 in Node 16+)
- docker 17.06+
- docker-compose
Installation
Global install
npm install -g @arc-fusion/cli
will install a command-line script on your system, globally accessible as fusion
.
Local install
npm install --save-dev @arc-fusion/cli
will install a command-line script in your repo, locally accessible as npx fusion
or npm run fusion
.
Testing
To test the CLI, you can either use npm link
in the local folder and npm link @arc-fusion/cli
in the repo or you can run npm install --no-save [path to local folder]
in the repo where you want to test it out. Then just run the command you need to test with npx fusion <command>
.
Linking
If you are using another npm package and need to test local changes, you will need to use npm link
. Follow the steps below to understand how to do this.
- Make sure your node and npm version matches the version used by the
FUSION_RELEASE
image - Go to the folder containing your package and npm
npm link
- Go to the folder containing your bundle and run
npm link [package name]
- If this package is published, make sure it is in the
dependencies
object in your package.json
file - If this package is not published, add it to the
devDependencies
object in your package.json
file manually (don't use npm i -D
), and save it - Start fusion via
npx fusion start
Commands
All commands should be run from within the repository, as fusion <command>
if installed globally, or npx fusion <command>
if installed locally.
daemon [--no-admin]
Run Fusion services in detached mode
down
Stop and remove containers, networks, images, and volumes
dump
Export the database into data/dumps/<timestamp>.tar.gz
init
Initialize the directory as a git repo, an npm package, and bootstrap the fusion directory structure
migrate
Migrate a legacy fusion repository to work with the fusion CLI
rebuild
Force a webpack rebuild of a running cluster
start [--no-admin]
Configure a docker-compose cluster to map npm linked modules, then start services.
This is also aliased as npm start
for convenience.
The start command may also be run with the --no-admin
flag to run the rendering services without the admin app.
If FUSION_REPO
is set in the .env
file of the repo, the local version of fusion will be used for development. This should be the absolute path to the directory the local fusion repo is in.
For themes development, there are a few additional flags you can use:
-l
or --links
: Use the local version of blocks for developement. Can optionally take a comma separated string of blocks to link instead of linking all of them (-l @org/block1,@org/block2
). This requires that you have THEMES_BLOCKS_REPO
set in your .env
file and it should be the absolute path to the directory the local blocks repo is in.- New for fusion 2.7.4 When linking an unpublished block, you will need to include
@org/block-name@local
in your blocks.json in addition to using the -l @org/block-name
flag. -f
or --rebuild
: Rebuild the webpack image and pull the latest version of the blocks.-p
or --production
: Force the image to use the published blocks. A developer can use any published tag canary
, beta
, stable
, hotfix
, or latest
.
We also allow a few additional environment variables (set in the repo's .env
file):
ENGINE_SDK_REPO
: This is used only for themes development. If set, this will use the local version of the engine sdk for development. This should be the absolute path to the directory the local engine sdk repo is in.CSS_FRAMEWORK_REPO
: This is used only for themes development. If set, this will use the local version of the css framework for development. This should be the absolute path to the directory the local css framework repo is in.THEME_COMPONENTS_REPO
: This is used only for themes development. If set, this will use the local version of the theme components for development. This should be the absolute path to the directory the local theme components repo is in.BLOCK_DIST_TAG
: This is used only for themes development. If set, this will control the version of all installed blocks that don't specify a version. The default is stable
.ENGINE_HEAP_SIZE
: If set, this changes the amount of memory (in MB) the engine image's node is allowed to use. The default is 2048
.WEBPACK_HEAP_SIZE
: If set, this changes the amount of memory (in MB) the webpack image's node is allowed to use. The default is 4096
.FUSION_RELEASE
: If set, this changes the version of Fusion used for the engine and webpack images. The default is latest
.CACHE_PROXY_RELEASE
: If set, this changes the version of Cache-Proxy used for the engine and webpack images. The default is latest
.ORIGIN_RELEASE
: If set, this changes the version of Origin used for the engine and webpack images. The default is latest
.RESOLVER_RELEASE
: If set, this changes the version of the resolver used for the engine image. The default is latest
.PORT
: If set, this changes the port Fusion uses. The default is 80
.DEBUG
: If set, this changes the logs you can see in the terminal. The default is arc.fusion.render.error
(only log rendering errors). You can set it to *
to see all logs.
There are a few environment variables you can use for testing/troubleshooting. We don't recommend setting these unless you know what you are doing/were directed to do so by support.
ENGINE_SDK_DIST_TAG
: This is used only for engine sdk in themes development. If set, this will control the version of engine sdk dependencies in blocks that don't specify a version.CSS_DIST_TAG
: This is used only for CSS frameworks in themes development. If set, this will control the version of CSS frameworks dependencies in blocks that don't specify a version.THEME_COMPONENTS_DIST_TAG
: This is used only for themes components in themes development. If set, this will control the version of theme components dependencies in blocks that don't specify a version.ORIGIN_SOURCE_DIR
: If set, this allows the origin to be built from a local directory instead of being pulled from Docker. You probably don't need to set this.ENGINE_SOURCE_DIR
: If set, this allows the engine to be built from a local directory instead of being pulled from Docker. You probably don't need to set this.RESOLVER_SOURCE_DIR
: If set, this allows the resolver to be built from a local directory instead of being pulled from Docker. You probably don't need to set this.CACHEPROXY_SOURCE_DIR
: If set, this allows the cache-proxy to be built from a local directory instead of being pulled from Docker. You probably don't need to set this.
stop
Stop services
verify
Run webpack on the repo source to ensure it has no compilation errors
zip
-f
or --force
: Skip verifying the bundle.-n
or --rename
: Change the generated zip file's name.
Create a zip file that is appropriate for upload into the fusion deployment system