Agave ToGo v2 is a full-featured web application providing a reference user interface to exercising the core functionality of the Agave Platform and demonstrate some of the advanced use cases made possible by the Agave Platform's Science API and open source web technologies.
This version of the web application is implemented as a client-side application using the AngularJS framework. It is designed to run entirely within your browser with no need for a back-end server. The Aside from the Agave Platform itself, there are no external third-party service dependencies. The assets produced by this project are entirely static, thus you may host this application out of your Bitbucket, GitHub, Dropbox, Google Drive, or even a folder you published using Agave.
Agave ToGo is fully open source under the BSD 2-Clause license. We encourage you to fork the project and use it as a jumping point from which you can build your own application. To contribute back enhancement and bug fixes, please make a pull request on the branch you have forked.
To get you started you can simply clone the angular-seed repository and install the dependencies:
You need git to clone the agave-togo
repository. You can get git from http://git-scm.com/.
We also use a number of node.js tools to initialize and test agave-togo. You must have node.js and its package manager (npm) installed. You can get them from http://nodejs.org/.
Clone the agave-togo repository using git:
git clone https://github.com/agaveplatform/agave-togo.git
cd agave-togo
If you just want to start a new project without the agave-togo commit history then you can do:
git clone --depth=1 https://github.com/agaveplatform/agave-togo.git <your-project-name>
The depth=1
tells git to only pull down one commit worth of historical data.
Dependencies in this project are handled by node package manager and bower via yarn. To build the project simply run the following command.
yarn install
Once the command completes, You should find that you have two new folders in your project.
node_modules
- contains the npm packages for the tools we needbower_components
- contains the angular framework files
You must set your own clientKey
and callbackUrl
in /agave-togo/auth/scripts/implicit.js
for authentication:
var OAuthClients = {
"agave.prod": {
"clientKey": "r7tbaux...",
"callbackUrl": "https://localhost:9000/auth/",
"createAccountUrl": "https://www.araport.org/user/register",
"scope": "PRODUCTION"
}
};
An easy way to register your client and obtain your clientKey
and callbackUrl
is through the CLI (https://github.com/agaveplatform/agave-cli):
$ tenants-init
Please select a tenant from the following list:
[0] agave.prod
Your choice [3]: 0
You are now configured to interact with the APIs at https://public.agaveapi.co/
$ clients-create -N "agave_client" -C "https://localhost:9000/auth/" -S
API username : yourusername
API password: yourpassword
Successfully created client agave_client
key: 2YR...
secret: NaH3...
$ auth-check -v
{
"tenantid": "agave.prod",
"baseurl": "https://public.agaveapi.co",
"devurl": "",
"apisecret": "NaH3...",
"apikey": "2YR...",
"username": "yourusername",
"access_token": "",
"refresh_token": "",
"created_at": "",
"expires_in": "",
"expires_at": ""
}
We have preconfigured the project with a simple development web server. The simplest way to start this server is:
gulp
Now browse to the app at https://localhost:9000/app.
Set your tenant BASEURI
and oAuthAccessToken
on /bower_components/agave-angularjs-sdk/Agave/TestConfiguration.js
:
Configuration.BASEURI = 'https://public.agaveapi.co';
Configuration.oAuthAccessToken = '37d51643...';
cd agave-togo
karma start
We also provide Agave ToGo as a Docker image. This repository is configured to build automatically and publish the resulting image to the [Docker Public Registry].
You need git to clone the agave-togo
repository. You can get git from http://git-scm.com/.
You will need to have the Docker Engine installed to perform the actual build.
Clone the image as you would above, then invoke the docker build
command.
git clone https://github.com/agaveplatform/agave-togo.git
cd agave-togo
docker build --rm=true -t agave-togo .
This will create an agave-togo
image based on the master branch of the repository that you can run anywhere.
To create and run the image as a Docker image, run the following command:
docker run -p 9000:9000 -n agave-togo agave-togo
The container will write the HTTP access logs to std out. You can view them using the docker logs
command:
docker logs agave-togo