This repository contains the command line utility for the API management solution 3scale.net.
Its main capabilities include importing an API definition (Open API / Swagger or RAML) into 3scale and:
- Importing and API definition (Open API / Swagger or RAML) to define your API
- Creating interactive documentation (ActiveDocs)
Additionally, you can also:
- Create, list, show, update, and delete services
- Create, list, show, and delete application plans
- Create, list, show, update, and delete mapping rules
- Create, list, show, update, and delete methods
- Create, list, show, update, and delete metrics
- List and show accounts
- Create, list, show, update, delete, suspend, and resume applications
- Show, and update proxy
- List, show, and promote proxy-configs
Note: Get familiar with the 3scale terminology reading through our support documentation.
To install run the command
npm install -g node-3scale-cli
Get started looking at the options by running the 'Help' command:
To see specific help for each one of the options, for example "activedocs", run:
3scale-cli activedocs --help
Before using the CLI tool you need to configure it and link it to your 3scale account:
3scale-cli config [ 3scale-cli ] Please answer the following questions to configure 3scale cli. ? 3scale access token 1234567890abc ? 3scale id awesome-api ? 3scale wildcard domain (3scale.net) [3scale-cli] 3scale cli tool configured
Your 3scale id corresponds to the domain of your 3scale admin portal as in
Your access token can be created and obtained according to the tutorial.
Config for on-prem
Some on-prem users had issues regarding hitting 3scale API on onprem installations as reported here.
The tool should be called with the
NODE_TLS_REJECT_UNAUTHORIZED=0 3scale-cli services list
A debug mode is available. To turn it on just add
DEBUG=* before your calls. It will print all debugs instructions.
DEBUG=* 3scale-cli services list
You can also turn debugs only for a specific part of the tool.
3scale-cli is open source, and we welcome anybody who wants to participate and contribute!
If you want to fix a bug or make any changes, please log an issue in GitHub describing the bug or new feature.
Get the code
The easiest way to get started with the code is to create your own fork of this repository, and then clone your fork:
$ git clone email@example.com:<you>/3scale-cli.git$ cd 3scale-cli$ git remote add upstream git://github.com/3scale/3scale-cli.git
At any time, you can pull changes from the upstream and merge them onto your master:
$ git checkout master # switches to the 'master' branch$ git pull upstream master # fetches all 'upstream' changes and merges 'upstream/master' onto your 'master' branch$ git push origin # pushes all the updates to your fork, which should be in-sync with 'upstream'
The general idea is to keep your 'master' branch in-sync with the 'upstream/master'.
Make a fix
If you want to fix a bug or make any changes, please log an issue in GitHub describing the bug or new feature. Then we highly recommend making the changes on a branch named with the issue number. For example, this command creates a branch for the issue #17 :
$ git checkout -b 3scale-cli-issue-17
After you're happy with your changes and a full build (with unit tests) runs successfully, commit your changes on your topic branch. Then it's time to check for and pull any recent changes that were made in the official repository:
$ git checkout master # switches to the 'master' branch$ git pull upstream master # fetches all 'upstream' changes and merges 'upstream/master' onto your 'master' branch$ git checkout 3scale-cli-issue-17 # switches to your topic branch$ git rebase master # reapplies your changes on top of the latest in master# (i.e., the latest from master will be the new base for your changes)
Push your changes and generate a pull-request
Please try to create one commit per feature or fix, generally the easiest way to do this is via git squash. This makes reverting changes easier, and avoids needlessly polluting the repository history with checkpoint commits.
$ npm install
The MIT License (MIT)
Copyright (c) 2015 3scale Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.