Browse Source

initial revision

master
Nicolas Massé 7 years ago
commit
44d1d84ca6
  1. 3
      .gitmodules
  2. 6
      archetypes/default.md
  3. 8
      config.toml
  4. 3
      content/api-lifecycle.md
  5. 5
      content/community.md
  6. 50
      content/docs-and-apis.md
  7. 72
      content/hello-world.md
  8. 11
      content/help.md
  9. 7
      content/overview.md
  10. 3
      content/try-it-out.md
  11. 21
      data/Menu.toml
  12. BIN
      static/hello-world/create-token.png
  13. BIN
      static/hello-world/docker-login.png
  14. BIN
      static/hello-world/download-openshift-secret.png
  15. BIN
      static/help/discussions.png
  16. BIN
      static/help/support.png
  17. 1
      themes/hyde-y

3
.gitmodules

@ -0,0 +1,3 @@
[submodule "theme"]
path = themes/hyde-y
url = https://github.com/enten/hyde-y.git

6
archetypes/default.md

@ -0,0 +1,6 @@
---
title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
draft: true
---

8
config.toml

@ -0,0 +1,8 @@
baseURL = "/overview/"
languageCode = "en-us"
title = "3scale API Management"
theme = "hyde-y"
[params]
topline = "Take control of your APIs, with unmatched scale, performance and flexibility!"
sidebar = "left"

3
content/api-lifecycle.md

@ -0,0 +1,3 @@
# API Lifecycle
TODO

5
content/community.md

@ -0,0 +1,5 @@
# Community
Using 3scale is a great way to build real-world enterprise applications based on the latest technologies. But what if you find something that needs fixing or have a new feature to suggest? By getting involved with the 3scale community you can give feedback, improve the docs, review code and discuss and propose new features whenever they’re needed. Answering user questions or taking part in development discussions is also a great way to build a reputation for collaboration and expertise in your field.
No matter what your skill level, contributing to 3scle can be very rewarding and a great learning experience. You’ll meet lots of smart, passionate developers who are all driven to create the best middleware possible in open source! You don’t have to be an expert to get involved and it doesn’t have to take a lot of time.

50
content/docs-and-apis.md

@ -0,0 +1,50 @@
# Docs and APIs
There are many resources available for Red Hat 3scale API Management here on Red Hat Developer Program, and on the [Red Hat Customer Portal](https://access.redhat.com/documentation/en-us/red_hat_3scale/). On this page, we highlight our pick of those resources.
## APIcast
**[Deployment Options](https://access.redhat.com/documentation/en-us/red_hat_3scale/2.3/html/deployment_options/)**
Deploy APIcast API Gateway on OpenShift, natively, or using Docker.
**[API Authentication](https://access.redhat.com/documentation/en-us/red_hat_3scale/2.3/html/api_authentication/)**
Choose your authentication pattern: API keys, app identifier and keys, or OAuth 2.0.
**[API Devops](https://access.redhat.com/documentation/en-us/red_hat_3scale/2.3/html/api_devops/)**
How to automate the deployment of your API Gateway using Chef, production tips, and more.
## 3scale Admin Portal
**[Quickstart](https://access.redhat.com/documentation/en-us/red_hat_3scale/2.3/html/quickstart/)**
This guide will help you get up and running to boost your API with 3scale in no time at all.
**[Product](https://access.redhat.com/documentation/en-us/red_hat_3scale/2.3/html/product/)**
Walkthrough of of different product features such as API integration, Analytics, Developer portal, and API environments.
**[Accounts](https://access.redhat.com/documentation/en-us/red_hat_3scale/2.3/html/accounts/)**
How to manage admin and member rights and invite teammates to use the admin portal.
**[Access Control](https://access.redhat.com/documentation/en-us/red_hat_3scale/2.3/html/access_control/)**
Define your API, create as many plans as you need and set up limits and pricing rules.
**[Analytics](https://access.redhat.com/documentation/en-us/red_hat_3scale/2.3/html/analytics/)**
Share API performance insights across the organization with crisp, clear reporting.
**[API Bizops](https://access.redhat.com/documentation/en-us/red_hat_3scale/2.3/html/api_bizops/)**
How to add / invite developers, account and application approvals, contacting developers, etc.
## 3scale Developer Portal
**[Developer Portal](https://access.redhat.com/documentation/en-us/red_hat_3scale/2.3/html/developer_portal/)**
A good developer portal is a must have to assure adoption of your API. Create yours in no time.
**[API Documentation](https://access.redhat.com/documentation/en-us/red_hat_3scale/2.3/html/api_documentation/)**
Make your API documentation clear, intuitive, and user friendly with 3scale ActiveDocs.
[See all Documentation versions](https://access.redhat.com/documentation/en-us/red_hat_3scale/)
# Red Hat 3scale API Management Supported Configurations
[Red Hat 3scale API Management 2.4 Supported Configurations](https://access.redhat.com/articles/2798521)
[Red Hat 3scale API Management 2.4 Component Details](https://access.redhat.com/articles/2787991)

72
content/hello-world.md

@ -0,0 +1,72 @@
# Hello, World!
## Pre-requisites: Create a token to access the Red Hat registry
You will need to create a token to be able to fetch APIcast from the Red Hat registry. Go to [access.redhat.com/terms-based-registry](https://access.redhat.com/terms-based-registry/), log in with your developer account (if you have not already done so), and click "New Service Account."
Give the token a name (for the rest of this article, we will use "3scale") and a meaningful description.
Click "Create" and the generated token is displayed. Save the username and the token in a safe place for future reference.
Click the "OpenShift Secret" tab and then "3scale-secret.yaml" to download your token in a format OpenShift will understand. Save it somewhere convenient for later use.
![Download OpenShift Secret](/hello-world/download-openshift-secret.png)
Click the "Docker Login" tab and copy the "docker login" command somewhere convenient for later use.
![Copy/paste the Docker login command](/hello-world/docker-login.png)
## Deploy APIcast on OpenShift
To install APIcast, you will need an OpenShift instance. If your company has one, use it. If not, we recommend using [Red Hat Container Development Kit (CDK)/minishift](https://developers.redhat.com/products/cdk/hello-world/). Minishift is an OpenShift installation targeted at developers that runs on your laptop. If you need to install CDK/minishift, see [these instructions](https://developers.redhat.com/products/cdk/hello-world/).
Spin up a minishift instance:
```raw
$ minishift start
```
Create a new project for your APIcast trial:
```raw
$ oc new-project 3scale
```
Inject the token you downloaded in the "Pre-requisites" section in your OpenShift project, as a secret:
```raw
$ oc create -f ~/Downloads/*_3scale-secret.yaml
```
Find the name of your secret:
```raw
$ oc get secret
NAME TYPE DATA AGE
10072637-3scale-pull-secret kubernetes.io/dockerconfigjson 1 3m
```
If you named your token "3scale" as suggested above, your secret should end with "-3scale-pull-secret." In this example, my secret is named "10072637-3scale-pull-secret."
Link your token with the default service account so that any pod in this project can use it (do not forget to change "10072637-sso-pull-secret" to your token name):
```raw
$ oc secrets link default 10072637-sso-pull-secret --for=pull
```
Import the APIcast ImageStream:
```raw
$ oc create -f https://raw.githubusercontent.com/3scale/3scale-amp-openshift-templates/2.4.0.GA/3scale-image-streams.yml
```
Import the OpenShift template:
```raw
$ oc create -f https://raw.githubusercontent.com/3scale/3scale-amp-openshift-templates/2.4.0.GA/apicast-gateway/apicast.yml
```
### Deploy APIcast on Docker
TODO

11
content/help.md

@ -0,0 +1,11 @@
# Help
## Community Q&A
See our most popular forum discussions related to Red Hat 3scale API Management.
![Support](/help/discussions.png)
# Red Hat Support and Professional Services
![Support](/help/support.png)

7
content/overview.md

@ -0,0 +1,7 @@
---
title: Overview
---
# Overview
TODO

3
content/try-it-out.md

@ -0,0 +1,3 @@
# Try it out!
TODO

21
data/Menu.toml

@ -0,0 +1,21 @@
[1-overview]
Name = "Overview"
URL = "/overview/"
[2-try-it-out]
Name = "Try it out!"
URL = "/try-it-out/"
[3-hello-world]
Name = "Hello, World!"
URL = "/hello-world/"
[4-docs]
Name = "Docs and APIs"
URL = "/docs-and-apis/"
[5-api-lifecycle]
Name = "API Lifecycle"
URL = "/api-lifecycle/"
[6-help]
Name = "Help"
URL = "/help/"
[7-community]
Name = "Community"
URL = "/community/"

BIN
static/hello-world/create-token.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 220 KiB

BIN
static/hello-world/docker-login.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 323 KiB

BIN
static/hello-world/download-openshift-secret.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 222 KiB

BIN
static/help/discussions.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 246 KiB

BIN
static/help/support.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 202 KiB

1
themes/hyde-y

@ -0,0 +1 @@
Subproject commit 5bbb9f8e65cf94f7bca87994fe585d052bedb005
Loading…
Cancel
Save