First of all, you need to make sure you have node
and npm
packages installed. Currently, we consider Node v14.x.x to be our stable.
$ n 20
installing : node-v20.8.1
mkdir : /home/enykeev/n/n/versions/node/20.8.1
fetch : https://nodejs.org/dist/v20.8.1/node-v20.8.1-linux-x64.tar.xz
copying : node/20.8.1
installed : v20.8.1 (with npm 10.1.0)
$ node -v
v20.8.1
$ npm -v
10.1.0
then you need to globally install gulp
, lerna
and yarn
$ sudo npm install -g gulp-cli lerna yarn
then you need to bootstrap the micromodules
$ lerna bootstrap
to avoid conflicts on node_modules, delete those generated by lerna:
$ rm -rf apps/st2-workflows/node_modules/
and finally run build system to fetch the font, compile css and so on
$ gulp
At that point you should be able to point your browser to http://localhost:3000/ and see the the page.
Note: docker-compose uses
config.local.js
which is gitignored and should be a copy ofconfig.js
with your specific values
Production:
docker-compose up
Dev:
docker-compose -f docker-compose.dev.yml up --build
Production with NGINX:
docker-compose -f docker-compose.nginx.yml up --build
Dev with NGINX:
docker-compose -f docker-compose.nginx-dev.yml up --build
While gulp
runs the longest chain of tasks including style compiling, spining up dev server and watching for changes, you can run all of them directly using gulp <task>
. Some common tasks are:
gulp build
- just lint and compile all the stuffgulp test
- build the project and then run e2e testsgulp serve
- build the project and start serving it at 3000 portgulp production
- build production version of the projectYou can see the whole list of tasks in gulpfile.js
.
Configure the CORS on StackStorm server: on your st2 installation, edit the following lines to [api] section in /etc/st2/st2.conf
:
[api]
# Host and port to bind the API server.
host = 0.0.0.0
port = 9101
logging = st2api/conf/logging.conf
# List of allowed origins for CORS, use when deploying st2web client
# The URL must match the one the browser uses to access the st2web
allow_origin = http://st2web.example.com:3000
Configure st2web to point to the right server. By default, UI tries to get its data relative to the st2web.
If for some reason st2web is served from another domain, edit config.js
at the root of the project and update the hosts
array with proper object of name, url and auth. URL should include scheme, domain and port in compliance with rfc1808. Auth might be either boolean (in which case the default schema and port is used) or a url of the auth server (see url requirements). For vagrant deployment of st2express, it would be:
hosts: [{
name: 'Express Deployment',
url: 'http://172.168.90.50:9101',
auth: true
}]
While gulp serve
is ideal for development purposes and quick preview, it requires browser to make lots and lots of requests downloading every single project file separately thus wasting a lot of time on making a request and waiting for response. Production version minimizes the number of files by concatenating them together and minifies some of the most heavy files reducing their size up to 5 times. It also makes compiled version completely independent of the rest of code allowing you to deploy it everywhere: static apache\nginx server, AWS, Heroku, Github Pages.
To build production version, run
$ gulp production
Then, you can find compiled version of the project in build/
folder. You can just copy it to the public folder your webserver, create symlink or push it to another repository as a deployment strategy.
We're using zombie as our headless browser for integration testing. It is a simulated environment (virtual DOM) so there's no need in WebDriver or a real browser to be present.
First of all, you need to make sure you have a running copy of st2 to run tests against. We're using official docker images for our automated tests, but the AIO deployment will work just as good (though will take more time to deploy).
To let test runner know the details of your st2 installation, you need to set ST2_PROTOCOL, ST2_HOST, ST2_USERNAME and ST2_PASSWORD env variables, then call gulp test
.
$ ST2_PROTOCOL=http ST2_HOST=localhost ST2_USERNAME=admin ST2_PASSWORD=123 gulp test
Copyright 2015-2019 Extreme Networks, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
By contributing you agree that these contributions are your own (or approved by your employer) and you grant a full, complete, irrevocable copyright license to all users and developers of the project, present and future, pursuant to the license of the project.