When attaching documentation in the API catalog we are advised…
If you are using API Blueprint, Tyk will use the aglio system to gnerate your API documentation. This means Aglio will need to be installed on the dashbaord system. Aglio look and feel can be modified and customised using the ‘jade’ folder in the tportal templates directory.
I checked out https://tyk.io/docs/tyk-dashboard-v1-0/developer-portal/api-catalogue/ and integrations instructions are light. Is it as simple as installing via NPM and generating the HTML to cover all APIs provided in the API Blueprint? Any Tyk configs or vars to set on Agilio to communicate with Tyk?
Thanks Martin! So I’ve already setup a Tky Gateway env with Gateway/Dash/Portal on SRV1, Mongo SRV2 and Redis SRV3 - everything seems to be doing what it should in the dashboard. AS I’m not doing Docker I assume I can NPM Install Aglio on SRV1
# Install Aglio (API Blueprint) - This is horrible
RUN curl -sL https://deb.nodesource.com/setup | bash -
RUN apt-get install -y nodejs
RUN npm install -g aglio
(seems simple, guess I’ll find out what is horrible about it…already have python build ess installed / Ubuntu 14.04)
If I succeed, then that’s it? No special pointers or vars or conf file changes?
EDIT: portal/jade/ folder and in portal/templates/ - I assume I would have to copy the aglio/templates files over to these dirs to the tyk/portal folders…?
Well, trying and have dependency issues on aglio build. I’ve got to move on…
I actually prefer / have more experience with swagger specs then with apiblueprint but absolutely hate the swagger UI. Looks like early 2000 crap to me and just the appearance puts out the wrong vibe of where I want to take this. Plus every time I open specs I worked so hard to build and look at that interface I kick my dog.