Comments (17)
@nijikokun what's the name of that tool that does virtual terminals in the browser?
from docs.konghq.com.
There are quite a few:
- http://www.erikosterberg.com/terminaljs/
- http://terminal.jcubic.pl/ (docker uses this one)
- http://gottox.de/terminal.js/
from docs.konghq.com.
will be very tricky for us, since we have an API for admin control, meaning parsing and mimicking cURL commands ... (vs. docker is pre-set cli commands)
better to use http://runnable.com/ and embed on site for an interactive setup with a REAL Kong instance ...
from docs.konghq.com.
here you go: http://runnable.com/VVVzgrrneBwFOSnA/
we can use this as a starting point for an interactive shell tutorial ...
from docs.konghq.com.
Thanks @ahmadnassri! Can you tell me how can I embed runnable terminal window? Only with iframe or there is proper way to do this?
@sinzone where should we place this tutorial? Maybe I should create separate docs section for it like http://take.ms/MKqae?
from docs.konghq.com.
with runnable.com there doesn't seem to be an embed function, and it seems to be the same session / server for everyone ... perhaps pointing people there is one way to do it, they can fork and create their own instance.
from docs.konghq.com.
"Try It" goes in the header bar and it's a new page. not in the doc.
runnable is nice but too bad doesn't have embedded feature and unique sessions. so, we need to go back to terminal emulators and just show a subset of feature, excluding API admin.
from docs.konghq.com.
but there are no features without the admin API ... all you can do is "start" and "stop"
from docs.konghq.com.
Well there is a PR to manipulate the data from the CLI too. It was not included in 0.3 but could have, we talked about it...
from docs.konghq.com.
if we get full control from the CLI, then we can build a faux terminal and use that for demos .... still a lot of work to mock everything (and keep updating it with new plugins / features) vs. a real instance ...
from docs.konghq.com.
Ok, I think we should wait until Kong with CLI data manipulation will be released. We will see than what we can do.
from docs.konghq.com.
we can try to put TRY IT which is a link to Runnable.
from docs.konghq.com.
closed with 9e18deb
from docs.konghq.com.
When I go to to runnable I try to use the terminal in the bottom (not clicking Run) and it doesn't work because that container and port is no longer running.
There's also another bug in the demo, you need to add a sleep 5
in main.sh between the request and starting Kong since the container won't be running by the time the script starts kong.
The biggest problem with sending people directly to runnable is it has no associated tutorial so it loses any benefit of teaching or showcasing functionality.
I have a full Kong demo available powered by docker + term.js that's online here for now: http://trykong.cloudbrain.io, we can get a new domain or point a subdomain to it like demo.getkong.org
.
Once 0.3.0
drops I'll update the image and we can switch it out for runnable. I wrote a small guide that I think is quicker and IMO a better showcase of Kong than the current 5 minute quickstart guide which we could use specifically for this purpose. My demo image also includes jq and siege so people can really play around with Kong, I also have it exposed to the public (try echo $HOST
in the demo) but kong doesn't support wildcard subdomains yet (Kong/kong#297) and honestly it might be better to not allow outside access for these purposes.
I'd like to create a special page with the tutorial so it looks more like this (removing sidebar, making terminal responsive by moving from side to bottom on smaller screens)
from docs.konghq.com.
@montanaflynn the runnable example was never meant to be used for this, @sinzone put it on afterwards as a temp.
from docs.konghq.com.
Alright then let's reopen this issue.
My demo with the guide and kong terminal loads super slow compared to trykong.cloudbrain.io:8080 which doesn't support copy + paste. The javascript is built with browserify and is huge (2+ mb) so it might be best to preload it on getkong.org. I'm waiting for 0.3.0 to come out so I can add a cache header using response transformation plugin which will make preloading a viable option.
from docs.konghq.com.
closing this in favor of upcoming Kong Cloud service
from docs.konghq.com.
Related Issues (20)
- Scrolling does not work on popups windows HOT 1
- 'Create Consumer Groups' subpage leads to 'How to create rate limiting tiers'
- Failure when following tutorial: Services and Routes HOT 1
- Create KGO-KIC compat matrix
- Document how to use OPA Bundles with Kong Mesh OPA Policy
- TLS Termination / Passthrough
- Add instructions for uploading OAS to Konnect Dev Portal
- KIC: Introduce annotations available for gateway API resources
- Demo-App discrepency between Kong Konnect Mesh and Kong Mesh documentation
- Update Kong Mesh pages to use Universal steps for Mesh Manager in Konnect
- No KIC 3.x KongConsumer or KongPlugin guide
- How to obtain host names post Dataplane creation
- The "OR" operator in expression router reference page is not correctly displayed
- MeshMetric: issue collection from Test Friday session HOT 1
- Managed Identity seems to be failing for Azure Container Apps for secret manager integration
- Improve Gateway API concerning protocol: HTTPS
- decK Add Documentation for Deck Config
- HMAC Auth examples not working as described
- KIC Konnect Set Up instructions HOT 1
- The endpoint to retrieve entity schema is incorrect
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docs.konghq.com.