Skip to content

Howto

Jump to bottom
Victor Buciuc edited this page Feb 2, 2021 · 2 revisions

Step by step api spec to subscribable catalog item via the cli

First create an environment

group: management
apiVersion: v1alpha1
kind: Environment
name: vibu
title: vibu
metadata:
spec:
  description: Teams environment

Then an APIService.

kind: APIService
name: petstore
metadata:
  scope:
    kind: Environment
    name: vibu
    spec: {}

The APIService revision will have the api specification in spec.definition.value (base64 encoded).

kind: APIServiceRevision
name: petstore
metadata:
  scope:
    kind: Environment
    name: vibu
spec:
  apiService: petstore
  definition:
    type: "oas2"
    value: eyJzd2FnZ2VyIjoiMi4wIiwiaW5mbyI6eyJkZXNjcmlwdGlvbiI6IlRoaXMgaXMgYSBzYW1wbGUgc2VydmVyIFBldHN0b3JlIHNlcnZlci4gIFlvdSBjYW4gZmluZCBvdXQgbW9yZSBhYm91dCBTd2FnZ2VyIGF0IFtodHRwOi8vc3dhZ2dlci5pb10oaHR0cDovL3N3YWdnZXIuaW8pIG9yIG9uIFtpcmMuZnJlZW5vZGUubmV0LCAjc3dhZ2dlcl0oaHR0cDovL3N3YWdnZXIuaW8vaXJjLykuICBGb3IgdGhpcyBzYW1wbGUsIHlvdSBjYW4gdXNlIHRoZSBhcGkga2V5IGBzcGVjaWFsLWtleWAgdG8gdGVzdCB0aGUgYXV0aG9yaXphdGlvbiBmaWx0ZXJzLiIsInZlcnNpb24iOiIxLjAuNSIsInRpdGxlIjoiU3dhZ2dlciBQZXRzdG9yZSIsInRlcm1zT2ZTZXJ2aWNlIjoiaHR0cDovL3N3YWdnZXIuaW8vdGVybXMvIiwiY29udGFjdCI6eyJlbWFpbCI6ImFwaXRlYW1Ac3dhZ2dlci5pbyJ9LCJsaWNlbnNlIjp7Im5hbWUiOiJBcGFjaGUgMi4wIiwidXJsIjoiaHR0cDovL3d3dy5hcGFjaGUub3JnL2xpY2Vuc2VzL0xJQ0VOU0UtMi4wLmh0bWwifX0sImhvc3QiOiJwZXRzdG9yZS5zd2FnZ2VyLmlvIiwiYmFzZVBhdGgiOiIvdjIiLCJ0YWdzIjpbeyJuYW1lIjoicGV0IiwiZGVzY3JpcHRpb24iOiJFdmVyeXRoaW5nIGFib3V0IHlvdXIgUGV0cyIsImV4dGVybmFsRG9jcyI6eyJkZXNjcmlwdGlvbiI6IkZpbmQgb3V0IG1vcmUiLCJ1cmwiOiJodHRwOi8vc3dhZ2dlci5pbyJ9fSx7Im5hbWUiOiJzdG9yZSIsImRlc2NyaXB0aW9uIjoiQWNjZXNzIHRvIFBldHN0b3JlIG9yZGVycyJ9LHsibmFtZSI6InVzZXIiLCJkZXNjcmlwdGlvbiI6Ik9wZXJhdGlvbnMgYWJvdXQgdXNlciIsImV4dGVybmFsRG9jcyI6eyJkZXNjcmlwdGlvbiI6IkZpbmQgb3V0IG1vcmUgYWJvdXQgb3VyIHN0b3JlIiwidXJsIjoiaHR0cDovL3N3YWdnZXIuaW8ifX1dLCJzY2hlbWVzIjpbImh0dHBzIiwiaHR0cCJdLCJwYXRocyI6eyIvcGV0L3twZXRJZH0vdXBsb2FkSW1hZ2UiOnsicG9zdCI6eyJ0YWdzIjpbInBldCJdLCJzdW1tYXJ5IjoidXBsb2FkcyBhbiBpbWFnZSIsImRlc2NyaXB0aW9uIjoiIiwib3BlcmF0aW9uSWQiOiJ1cGxvYWRGaWxlIiwiY29uc3VtZXMiOlsibXVsdGlwYXJ0L2Zvcm0tZGF0YSJdLCJwcm9kdWNlcyI6WyJhcHBsaWNhdGlvbi9qc29uIl0sInBhcmFtZXRlcnMiOlt7Im5hbWUiOiJwZXRJZCIsImluIjoicGF0aCIsImRlc2NyaXB0aW9uIjoiSUQgb2YgcGV0IHRvIHVwZGF0ZSIsInJlcXVpcmVkIjp0cnVlLCJ0eXBlIjoiaW50ZWdlciIsImZvcm1hdCI6ImludDY0In0seyJuYW1lIjoiYWRkaXRpb25hbE1ldGFkYXRhIiwiaW4iOiJmb3JtRGF0YSIsImRlc2NyaXB0aW9uIjoiQWRkaXRpb25hbCBkYXRhIHRvIHBhc3MgdG8gc2VydmVyIiwicmVxdWlyZWQiOmZhbHNlLCJ0eXBlIjoic3RyaW5nIn0seyJuYW1lIjoiZmlsZSIsImluIjoiZm9ybURhdGEiLCJkZXNjcmlwdGlvbiI6ImZpbGUgdG8gdXBsb2FkIiwicmVxdWlyZWQiOmZhbHNlLCJ0eXBlIjoiZmlsZSJ9XSwicmVzcG9uc2VzIjp7IjIwMCI6eyJkZXNjcmlwdGlvbiI6InN1Y2Nlc3NmdWwgb3BlcmF0aW9uIiwic2NoZW1hIjp7IiRyZWYiOiIjL2RlZmluaXRpb25zL0FwaVJlc3BvbnNlIn19fSwic2VjdXJpdHkiOlt7InBldHN0b3JlX2F1dGgiOlsid3JpdGU6cGV0cyIsInJlYWQ6cGV0cyJdfV19fSwiL3BldCI6eyJwb3N0Ijp7InRhZ3MiOlsicGV0Il0sInN1bW1hcnkiOiJBZGQgYSBuZXcgcGV0IHRvIHRoZSBzdG9yZSIsImRlc2NyaXB0aW9uIjoiIiwib3BlcmF0aW9uSWQiOiJhZGRQZXQiLCJjb25zdW1lcyI6WyJhcHBsaWNhdGlvbi9qc29uIiwiYXBwbGljYXRpb24veG1sIl0sInByb2R1Y2VzIjpbImFwcGxpY2F0aW9uL2pzb24iLCJhcHBsaWNhdGlvbi94bWwiXSwicGFyYW1ldGVycyI6W3siaW4iOiJib2R5IiwibmFtZSI6ImJvZHkiLCJkZXNjcmlwdGlvbiI6IlBldCBvYmplY3QgdGhhdCBuZWVkcyB0byBiZSBhZGRlZCB0byB0aGUgc3RvcmUiLCJyZXF1aXJlZCI6dHJ1ZSwic2NoZW1hIjp7IiRyZWYiOiIjL2RlZmluaXRpb25zL1BldCJ9fV0sInJlc3BvbnNlcyI6eyI0MDUiOnsiZGVzY3JpcHRpb24iOiJJbnZhbGlkIGlucHV0In19LCJzZWN1cml0eSI6W3sicGV0c3RvcmVfYXV0aCI6WyJ3cml0ZTpwZXRzIiwicmVhZDpwZXRzIl19XX0sInB1dCI6eyJ0YWdzIjpbInBldCJdLCJzdW1tYXJ5IjoiVXBkYXRlIGFuIGV4aXN0aW5nIHBldCIsImRlc2NyaXB0aW9uIjoiIiwib3BlcmF0aW9uSWQiOiJ1cGRhdGVQZXQiLCJjb25zdW1lcyI6WyJhcHBsaWNhdGlvbi9qc29uIiwiYXBwbGljYXRpb24veG1sIl0sInByb2R1Y2VzIjpbImFwcGxpY2F0aW9uL2pzb24iLCJhcHBsaWNhdGlvbi94bWwiXSwicGFyYW1ldGVycyI6W3siaW4iOiJib2R5IiwibmFtZSI6ImJvZHkiLCJkZXNjcmlwdGlvbiI6IlBldCBvYmplY3QgdGhhdCBuZWVkcyB0byBiZSBhZGRlZCB0byB0aGUgc3RvcmUiLCJyZXF1aXJlZCI6dHJ1ZSwic2NoZW1hIjp7IiRyZWYiOiIjL2RlZmluaXRpb25zL1BldCJ9fV0sInJlc3BvbnNlcyI6eyI0MDAiOnsiZGVzY3JpcHRpb24iOiJJbnZhbGlkIElEIHN1cHBsaWVkIn0sIjQwNCI6eyJkZXNjcmlwdGlvbiI6IlBldCBub3QgZm91bmQifSwiNDA1Ijp7ImRlc2NyaXB0aW9uIjoiVmFsaWRhdGlvbiBleGNlcHRpb24ifX0sInNlY3VyaXR5IjpbeyJwZXRzdG9yZV9hdXRoIjpbIndyaXRlOnBldHMiLCJyZWFkOnBldHMiXX1dfX0sIi9wZXQvZmluZEJ5U3RhdHVzIjp7ImdldCI6eyJ0YWdzIjpbInBldCJdLCJzdW1tYXJ5IjoiRmluZHMgUGV0cyBieSBzdGF0dXMiLCJkZXNjcmlwdGlvbiI6Ik11bHRpcGxlIHN0YXR1cyB2YWx1ZXMgY2FuIGJlIHByb3ZpZGVkIHdpdGggY29tbWEgc2VwYXJhdGVkIHN0cmluZ3MiLCJvcGVyYXRpb25JZCI6ImZpbmRQZXRzQnlTdGF0dXMiLCJwcm9kdWNlcyI6WyJhcHBsaWNhdGlvbi9qc29uIiwiYXBwbGljYXRpb24veG1sIl0sInBhcmFtZXRlcnMiOlt7Im5hbWUiOiJzdGF0dXMiLCJpbiI6InF1ZXJ5IiwiZGVzY3JpcHRpb24iOiJTdGF0dXMgdmFsdWVzIHRoYXQgbmVlZCB0byBiZSBjb25zaWRlcmVkIGZvciBmaWx0ZXIiLCJyZXF1aXJlZCI6dHJ1ZSwidHlwZSI6ImFycmF5IiwiaXRlbXMiOnsidHlwZSI6InN0cmluZyIsImVudW0iOlsiYXZhaWxhYmxlIiwicGVuZGluZyIsInNvbGQiXSwiZGVmYXVsdCI6ImF2YWlsYWJsZSJ9LCJjb2xsZWN0aW9uRm9ybWF0IjoibXVsdGkifV0sInJlc3BvbnNlcyI6eyIyMDAiOnsiZGVzY3JpcHRpb24iOiJzdWNjZXNzZnVsIG9wZXJhdGlvbiIsInNjaGVtYSI6eyJ0eXBlIjoiYXJyYXkiLCJpdGVtcyI6eyIkcmVmIjoiIy9kZWZpbml0aW9ucy9QZXQifX19LCI0MDAiOnsiZGVzY3JpcHRpb24iOiJJbnZhbGlkIHN0YXR1cyB2YWx1ZSJ9fSwic2VjdXJpdHkiOlt7InBldHN0b3JlX2F1dGgiOlsid3JpdGU6cGV0cyIsInJlYWQ6cGV0cyJdfV19fSwiL3BldC9maW5kQnlUYWdzIjp7ImdldCI6eyJ0YWdzIjpbInBldCJdLCJzdW1tYXJ5IjoiRmluZHMgUGV0cyBieSB0YWdzIiwiZGVzY3JpcHRpb24iOiJNdWx0aXBsZSB0YWdzIGNhbiBiZSBwcm92aWRlZCB3aXRoIGNvbW1hIHNlcGFyYXRlZCBzdHJpbmdzLiBVc2UgdGFnMSwgdGFnMiwgdGFnMyBmb3IgdGVzdGluZy4iLCJvcGVyYXRpb25JZCI6ImZpbmRQZXRzQnlUYWdzIiwicHJvZHVjZXMiOlsiYXBwbGljYXRpb24vanNvbiIsImFwcGxpY2F0aW9uL3htbCJdLCJwYXJhbWV0ZXJzIjpbeyJuYW1lIjoidGFncyIsImluIjoicXVlcnkiLCJkZXNjcmlwdGlvbiI6IlRhZ3MgdG8gZmlsdGVyIGJ5IiwicmVxdWlyZWQiOnRydWUsInR5cGUiOiJhcnJheSIsIml0ZW1zIjp7InR5cGUiOiJzdHJpbmcifSwiY29sbGVjdGlvbkZvcm1hdCI6Im11bHRpIn1dLCJyZXNwb25zZXMiOnsiMjAwIjp7ImRlc2NyaXB0aW9uIjoic3VjY2Vzc2Z1bCBvcGVyYXRpb24iLCJzY2hlbWEiOnsidHlwZSI6ImFycmF5IiwiaXRlbXMiOnsiJHJlZiI6IiMvZGVmaW5pdGlvbnMvUGV0In19fSwiNDAwIjp7ImRlc2NyaXB0aW9uIjoiSW52YWxpZCB0YWcgdmFsdWUifX0sInNlY3VyaXR5IjpbeyJwZXRzdG9yZV9hdXRoIjpbIndyaXRlOnBldHMiLCJyZWFkOnBldHMiXX1dLCJkZXByZWNhdGVkIjp0cnVlfX0sIi9wZXQve3BldElkfSI6eyJnZXQiOnsidGFncyI6WyJwZXQiXSwic3VtbWFyeSI6IkZpbmQgcGV0IGJ5IElEIiwiZGVzY3JpcHRpb24iOiJSZXR1cm5zIGEgc2luZ2xlIHBldCIsIm9wZXJhdGlvbklkIjoiZ2V0UGV0QnlJZCIsInByb2R1Y2VzIjpbImFwcGxpY2F0aW9uL2pzb24iLCJhcHBsaWNhdGlvbi94bWwiXSwicGFyYW1ldGVycyI6W3sibmFtZSI6InBldElkIiwiaW4iOiJwYXRoIiwiZGVzY3JpcHRpb24iOiJJRCBvZiBwZXQgdG8gcmV0dXJuIiwicmVxdWlyZWQiOnRydWUsInR5cGUiOiJpbnRlZ2VyIiwiZm9ybWF0IjoiaW50NjQifV0sInJlc3BvbnNlcyI6eyIyMDAiOnsiZGVzY3JpcHRpb24iOiJzdWNjZXNzZnVsIG9wZXJhdGlvbiIsInNjaGVtYSI6eyIkcmVmIjoiIy9kZWZpbml0aW9ucy9QZXQifX0sIjQwMCI6eyJkZXNjcmlwdGlvbiI6IkludmFsaWQgSUQgc3VwcGxpZWQifSwiNDA0Ijp7ImRlc2NyaXB0aW9uIjoiUGV0IG5vdCBmb3VuZCJ9fSwic2VjdXJpdHkiOlt7ImFwaV9rZXkiOltdfV19LCJwb3N0Ijp7InRhZ3MiOlsicGV0Il0sInN1bW1hcnkiOiJVcGRhdGVzIGEgcGV0IGluIHRoZSBzdG9yZSB3aXRoIGZvcm0gZGF0YSIsImRlc2NyaXB0aW9uIjoiIiwib3BlcmF0aW9uSWQiOiJ1cGRhdGVQZXRXaXRoRm9ybSIsImNvbnN1bWVzIjpbImFwcGxpY2F0aW9uL3gtd3d3LWZvcm0tdXJsZW5jb2RlZCJdLCJwcm9kdWNlcyI6WyJhcHBsaWNhdGlvbi9qc29uIiwiYXBwbGljYXRpb24veG1sIl0sInBhcmFtZXRlcnMiOlt7Im5hbWUiOiJwZXRJZCIsImluIjoicGF0aCIsImRlc2NyaXB0aW9uIjoiSUQgb2YgcGV0IHRoYXQgbmVlZHMgdG8gYmUgdXBkYXRlZCIsInJlcXVpcmVkIjp0cnVlLCJ0eXBlIjoiaW50ZWdlciIsImZvcm1hdCI6ImludDY0In0seyJuYW1lIjoibmFtZSIsImluIjoiZm9ybURhdGEiLCJkZXNjcmlwdGlvbiI6IlVwZGF0ZWQgbmFtZSBvZiB0aGUgcGV0IiwicmVxdWlyZWQiOmZhbHNlLCJ0eXBlIjoic3RyaW5nIn0seyJuYW1lIjoic3RhdHVzIiwiaW4iOiJmb3JtRGF0YSIsImRlc2NyaXB0aW9uIjoiVXBkYXRlZCBzdGF0dXMgb2YgdGhlIHBldCIsInJlcXVpcmVkIjpmYWxzZSwidHlwZSI6InN0cmluZyJ9XSwicmVzcG9uc2VzIjp7IjQwNSI6eyJkZXNjcmlwdGlvbiI6IkludmFsaWQgaW5wdXQifX0sInNlY3VyaXR5IjpbeyJwZXRzdG9yZV9hdXRoIjpbIndyaXRlOnBldHMiLCJyZWFkOnBldHMiXX1dfSwiZGVsZXRlIjp7InRhZ3MiOlsicGV0Il0sInN1bW1hcnkiOiJEZWxldGVzIGEgcGV0IiwiZGVzY3JpcHRpb24iOiIiLCJvcGVyYXRpb25JZCI6ImRlbGV0ZVBldCIsInByb2R1Y2VzIjpbImFwcGxpY2F0aW9uL2pzb24iLCJhcHBsaWNhdGlvbi94bWwiXSwicGFyYW1ldGVycyI6W3sibmFtZSI6ImFwaV9rZXkiLCJpbiI6ImhlYWRlciIsInJlcXVpcmVkIjpmYWxzZSwidHlwZSI6InN0cmluZyJ9LHsibmFtZSI6InBldElkIiwiaW4iOiJwYXRoIiwiZGVzY3JpcHRpb24iOiJQZXQgaWQgdG8gZGVsZXRlIiwicmVxdWlyZWQiOnRydWUsInR5cGUiOiJpbnRlZ2VyIiwiZm9ybWF0IjoiaW50NjQifV0sInJlc3BvbnNlcyI6eyI0MDAiOnsiZGVzY3JpcHRpb24iOiJJbnZhbGlkIElEIHN1cHBsaWVkIn0sIjQwNCI6eyJkZXNjcmlwdGlvbiI6IlBldCBub3QgZm91bmQifX0sInNlY3VyaXR5IjpbeyJwZXRzdG9yZV9hdXRoIjpbIndyaXRlOnBldHMiLCJyZWFkOnBldHMiXX1dfX0sIi9zdG9yZS9vcmRlciI6eyJwb3N0Ijp7InRhZ3MiOlsic3RvcmUiXSwic3VtbWFyeSI6IlBsYWNlIGFuIG9yZGVyIGZvciBhIHBldCIsImRlc2NyaXB0aW9uIjoiIiwib3BlcmF0aW9uSWQiOiJwbGFjZU9yZGVyIiwiY29uc3VtZXMiOlsiYXBwbGljYXRpb24vanNvbiJdLCJwcm9kdWNlcyI6WyJhcHBsaWNhdGlvbi9qc29uIiwiYXBwbGljYXRpb24veG1sIl0sInBhcmFtZXRlcnMiOlt7ImluIjoiYm9keSIsIm5hbWUiOiJib2R5IiwiZGVzY3JpcHRpb24iOiJvcmRlciBwbGFjZWQgZm9yIHB1cmNoYXNpbmcgdGhlIHBldCIsInJlcXVpcmVkIjp0cnVlLCJzY2hlbWEiOnsiJHJlZiI6IiMvZGVmaW5pdGlvbnMvT3JkZXIifX1dLCJyZXNwb25zZXMiOnsiMjAwIjp7ImRlc2NyaXB0aW9uIjoic3VjY2Vzc2Z1bCBvcGVyYXRpb24iLCJzY2hlbWEiOnsiJHJlZiI6IiMvZGVmaW5pdGlvbnMvT3JkZXIifX0sIjQwMCI6eyJkZXNjcmlwdGlvbiI6IkludmFsaWQgT3JkZXIifX19fSwiL3N0b3JlL29yZGVyL3tvcmRlcklkfSI6eyJnZXQiOnsidGFncyI6WyJzdG9yZSJdLCJzdW1tYXJ5IjoiRmluZCBwdXJjaGFzZSBvcmRlciBieSBJRCIsImRlc2NyaXB0aW9uIjoiRm9yIHZhbGlkIHJlc3BvbnNlIHRyeSBpbnRlZ2VyIElEcyB3aXRoIHZhbHVlID49IDEgYW5kIDw9IDEwLiBPdGhlciB2YWx1ZXMgd2lsbCBnZW5lcmF0ZWQgZXhjZXB0aW9ucyIsIm9wZXJhdGlvbklkIjoiZ2V0T3JkZXJCeUlkIiwicHJvZHVjZXMiOlsiYXBwbGljYXRpb24vanNvbiIsImFwcGxpY2F0aW9uL3htbCJdLCJwYXJhbWV0ZXJzIjpbeyJuYW1lIjoib3JkZXJJZCIsImluIjoicGF0aCIsImRlc2NyaXB0aW9uIjoiSUQgb2YgcGV0IHRoYXQgbmVlZHMgdG8gYmUgZmV0Y2hlZCIsInJlcXVpcmVkIjp0cnVlLCJ0eXBlIjoiaW50ZWdlciIsIm1heGltdW0iOjEwLCJtaW5pbXVtIjoxLCJmb3JtYXQiOiJpbnQ2NCJ9XSwicmVzcG9uc2VzIjp7IjIwMCI6eyJkZXNjcmlwdGlvbiI6InN1Y2Nlc3NmdWwgb3BlcmF0aW9uIiwic2NoZW1hIjp7IiRyZWYiOiIjL2RlZmluaXRpb25zL09yZGVyIn19LCI0MDAiOnsiZGVzY3JpcHRpb24iOiJJbnZhbGlkIElEIHN1cHBsaWVkIn0sIjQwNCI6eyJkZXNjcmlwdGlvbiI6Ik9yZGVyIG5vdCBmb3VuZCJ9fX0sImRlbGV0ZSI6eyJ0YWdzIjpbInN0b3JlIl0sInN1bW1hcnkiOiJEZWxldGUgcHVyY2hhc2Ugb3JkZXIgYnkgSUQiLCJkZXNjcmlwdGlvbiI6IkZvciB2YWxpZCByZXNwb25zZSB0cnkgaW50ZWdlciBJRHMgd2l0aCBwb3NpdGl2ZSBpbnRlZ2VyIHZhbHVlLiBOZWdhdGl2ZSBvciBub24taW50ZWdlciB2YWx1ZXMgd2lsbCBnZW5lcmF0ZSBBUEkgZXJyb3JzIiwib3BlcmF0aW9uSWQiOiJkZWxldGVPcmRlciIsInByb2R1Y2VzIjpbImFwcGxpY2F0aW9uL2pzb24iLCJhcHBsaWNhdGlvbi94bWwiXSwicGFyYW1ldGVycyI6W3sibmFtZSI6Im9yZGVySWQiLCJpbiI6InBhdGgiLCJkZXNjcmlwdGlvbiI6IklEIG9mIHRoZSBvcmRlciB0aGF0IG5lZWRzIHRvIGJlIGRlbGV0ZWQiLCJyZXF1aXJlZCI6dHJ1ZSwidHlwZSI6ImludGVnZXIiLCJtaW5pbXVtIjoxLCJmb3JtYXQiOiJpbnQ2NCJ9XSwicmVzcG9uc2VzIjp7IjQwMCI6eyJkZXNjcmlwdGlvbiI6IkludmFsaWQgSUQgc3VwcGxpZWQifSwiNDA0Ijp7ImRlc2NyaXB0aW9uIjoiT3JkZXIgbm90IGZvdW5kIn19fX0sIi9zdG9yZS9pbnZlbnRvcnkiOnsiZ2V0Ijp7InRhZ3MiOlsic3RvcmUiXSwic3VtbWFyeSI6IlJldHVybnMgcGV0IGludmVudG9yaWVzIGJ5IHN0YXR1cyIsImRlc2NyaXB0aW9uIjoiUmV0dXJucyBhIG1hcCBvZiBzdGF0dXMgY29kZXMgdG8gcXVhbnRpdGllcyIsIm9wZXJhdGlvbklkIjoiZ2V0SW52ZW50b3J5IiwicHJvZHVjZXMiOlsiYXBwbGljYXRpb24vanNvbiJdLCJwYXJhbWV0ZXJzIjpbXSwicmVzcG9uc2VzIjp7IjIwMCI6eyJkZXNjcmlwdGlvbiI6InN1Y2Nlc3NmdWwgb3BlcmF0aW9uIiwic2NoZW1hIjp7InR5cGUiOiJvYmplY3QiLCJhZGRpdGlvbmFsUHJvcGVydGllcyI6eyJ0eXBlIjoiaW50ZWdlciIsImZvcm1hdCI6ImludDMyIn19fX0sInNlY3VyaXR5IjpbeyJhcGlfa2V5IjpbXX1dfX0sIi91c2VyL2NyZWF0ZVdpdGhBcnJheSI6eyJwb3N0Ijp7InRhZ3MiOlsidXNlciJdLCJzdW1tYXJ5IjoiQ3JlYXRlcyBsaXN0IG9mIHVzZXJzIHdpdGggZ2l2ZW4gaW5wdXQgYXJyYXkiLCJkZXNjcmlwdGlvbiI6IiIsIm9wZXJhdGlvbklkIjoiY3JlYXRlVXNlcnNXaXRoQXJyYXlJbnB1dCIsImNvbnN1bWVzIjpbImFwcGxpY2F0aW9uL2pzb24iXSwicHJvZHVjZXMiOlsiYXBwbGljYXRpb24vanNvbiIsImFwcGxpY2F0aW9uL3htbCJdLCJwYXJhbWV0ZXJzIjpbeyJpbiI6ImJvZHkiLCJuYW1lIjoiYm9keSIsImRlc2NyaXB0aW9uIjoiTGlzdCBvZiB1c2VyIG9iamVjdCIsInJlcXVpcmVkIjp0cnVlLCJzY2hlbWEiOnsidHlwZSI6ImFycmF5IiwiaXRlbXMiOnsiJHJlZiI6IiMvZGVmaW5pdGlvbnMvVXNlciJ9fX1dLCJyZXNwb25zZXMiOnsiZGVmYXVsdCI6eyJkZXNjcmlwdGlvbiI6InN1Y2Nlc3NmdWwgb3BlcmF0aW9uIn19fX0sIi91c2VyL2NyZWF0ZVdpdGhMaXN0Ijp7InBvc3QiOnsidGFncyI6WyJ1c2VyIl0sInN1bW1hcnkiOiJDcmVhdGVzIGxpc3Qgb2YgdXNlcnMgd2l0aCBnaXZlbiBpbnB1dCBhcnJheSIsImRlc2NyaXB0aW9uIjoiIiwib3BlcmF0aW9uSWQiOiJjcmVhdGVVc2Vyc1dpdGhMaXN0SW5wdXQiLCJjb25zdW1lcyI6WyJhcHBsaWNhdGlvbi9qc29uIl0sInByb2R1Y2VzIjpbImFwcGxpY2F0aW9uL2pzb24iLCJhcHBsaWNhdGlvbi94bWwiXSwicGFyYW1ldGVycyI6W3siaW4iOiJib2R5IiwibmFtZSI6ImJvZHkiLCJkZXNjcmlwdGlvbiI6Ikxpc3Qgb2YgdXNlciBvYmplY3QiLCJyZXF1aXJlZCI6dHJ1ZSwic2NoZW1hIjp7InR5cGUiOiJhcnJheSIsIml0ZW1zIjp7IiRyZWYiOiIjL2RlZmluaXRpb25zL1VzZXIifX19XSwicmVzcG9uc2VzIjp7ImRlZmF1bHQiOnsiZGVzY3JpcHRpb24iOiJzdWNjZXNzZnVsIG9wZXJhdGlvbiJ9fX19LCIvdXNlci97dXNlcm5hbWV9Ijp7ImdldCI6eyJ0YWdzIjpbInVzZXIiXSwic3VtbWFyeSI6IkdldCB1c2VyIGJ5IHVzZXIgbmFtZSIsImRlc2NyaXB0aW9uIjoiIiwib3BlcmF0aW9uSWQiOiJnZXRVc2VyQnlOYW1lIiwicHJvZHVjZXMiOlsiYXBwbGljYXRpb24vanNvbiIsImFwcGxpY2F0aW9uL3htbCJdLCJwYXJhbWV0ZXJzIjpbeyJuYW1lIjoidXNlcm5hbWUiLCJpbiI6InBhdGgiLCJkZXNjcmlwdGlvbiI6IlRoZSBuYW1lIHRoYXQgbmVlZHMgdG8gYmUgZmV0Y2hlZC4gVXNlIHVzZXIxIGZvciB0ZXN0aW5nLiAiLCJyZXF1aXJlZCI6dHJ1ZSwidHlwZSI6InN0cmluZyJ9XSwicmVzcG9uc2VzIjp7IjIwMCI6eyJkZXNjcmlwdGlvbiI6InN1Y2Nlc3NmdWwgb3BlcmF0aW9uIiwic2NoZW1hIjp7IiRyZWYiOiIjL2RlZmluaXRpb25zL1VzZXIifX0sIjQwMCI6eyJkZXNjcmlwdGlvbiI6IkludmFsaWQgdXNlcm5hbWUgc3VwcGxpZWQifSwiNDA0Ijp7ImRlc2NyaXB0aW9uIjoiVXNlciBub3QgZm91bmQifX19LCJwdXQiOnsidGFncyI6WyJ1c2VyIl0sInN1bW1hcnkiOiJVcGRhdGVkIHVzZXIiLCJkZXNjcmlwdGlvbiI6IlRoaXMgY2FuIG9ubHkgYmUgZG9uZSBieSB0aGUgbG9nZ2VkIGluIHVzZXIuIiwib3BlcmF0aW9uSWQiOiJ1cGRhdGVVc2VyIiwiY29uc3VtZXMiOlsiYXBwbGljYXRpb24vanNvbiJdLCJwcm9kdWNlcyI6WyJhcHBsaWNhdGlvbi9qc29uIiwiYXBwbGljYXRpb24veG1sIl0sInBhcmFtZXRlcnMiOlt7Im5hbWUiOiJ1c2VybmFtZSIsImluIjoicGF0aCIsImRlc2NyaXB0aW9uIjoibmFtZSB0aGF0IG5lZWQgdG8gYmUgdXBkYXRlZCIsInJlcXVpcmVkIjp0cnVlLCJ0eXBlIjoic3RyaW5nIn0seyJpbiI6ImJvZHkiLCJuYW1lIjoiYm9keSIsImRlc2NyaXB0aW9uIjoiVXBkYXRlZCB1c2VyIG9iamVjdCIsInJlcXVpcmVkIjp0cnVlLCJzY2hlbWEiOnsiJHJlZiI6IiMvZGVmaW5pdGlvbnMvVXNlciJ9fV0sInJlc3BvbnNlcyI6eyI0MDAiOnsiZGVzY3JpcHRpb24iOiJJbnZhbGlkIHVzZXIgc3VwcGxpZWQifSwiNDA0Ijp7ImRlc2NyaXB0aW9uIjoiVXNlciBub3QgZm91bmQifX19LCJkZWxldGUiOnsidGFncyI6WyJ1c2VyIl0sInN1bW1hcnkiOiJEZWxldGUgdXNlciIsImRlc2NyaXB0aW9uIjoiVGhpcyBjYW4gb25seSBiZSBkb25lIGJ5IHRoZSBsb2dnZWQgaW4gdXNlci4iLCJvcGVyYXRpb25JZCI6ImRlbGV0ZVVzZXIiLCJwcm9kdWNlcyI6WyJhcHBsaWNhdGlvbi9qc29uIiwiYXBwbGljYXRpb24veG1sIl0sInBhcmFtZXRlcnMiOlt7Im5hbWUiOiJ1c2VybmFtZSIsImluIjoicGF0aCIsImRlc2NyaXB0aW9uIjoiVGhlIG5hbWUgdGhhdCBuZWVkcyB0byBiZSBkZWxldGVkIiwicmVxdWlyZWQiOnRydWUsInR5cGUiOiJzdHJpbmcifV0sInJlc3BvbnNlcyI6eyI0MDAiOnsiZGVzY3JpcHRpb24iOiJJbnZhbGlkIHVzZXJuYW1lIHN1cHBsaWVkIn0sIjQwNCI6eyJkZXNjcmlwdGlvbiI6IlVzZXIgbm90IGZvdW5kIn19fX0sIi91c2VyL2xvZ2luIjp7ImdldCI6eyJ0YWdzIjpbInVzZXIiXSwic3VtbWFyeSI6IkxvZ3MgdXNlciBpbnRvIHRoZSBzeXN0ZW0iLCJkZXNjcmlwdGlvbiI6IiIsIm9wZXJhdGlvbklkIjoibG9naW5Vc2VyIiwicHJvZHVjZXMiOlsiYXBwbGljYXRpb24vanNvbiIsImFwcGxpY2F0aW9uL3htbCJdLCJwYXJhbWV0ZXJzIjpbeyJuYW1lIjoidXNlcm5hbWUiLCJpbiI6InF1ZXJ5IiwiZGVzY3JpcHRpb24iOiJUaGUgdXNlciBuYW1lIGZvciBsb2dpbiIsInJlcXVpcmVkIjp0cnVlLCJ0eXBlIjoic3RyaW5nIn0seyJuYW1lIjoicGFzc3dvcmQiLCJpbiI6InF1ZXJ5IiwiZGVzY3JpcHRpb24iOiJUaGUgcGFzc3dvcmQgZm9yIGxvZ2luIGluIGNsZWFyIHRleHQiLCJyZXF1aXJlZCI6dHJ1ZSwidHlwZSI6InN0cmluZyJ9XSwicmVzcG9uc2VzIjp7IjIwMCI6eyJkZXNjcmlwdGlvbiI6InN1Y2Nlc3NmdWwgb3BlcmF0aW9uIiwiaGVhZGVycyI6eyJYLUV4cGlyZXMtQWZ0ZXIiOnsidHlwZSI6InN0cmluZyIsImZvcm1hdCI6ImRhdGUtdGltZSIsImRlc2NyaXB0aW9uIjoiZGF0ZSBpbiBVVEMgd2hlbiB0b2tlbiBleHBpcmVzIn0sIlgtUmF0ZS1MaW1pdCI6eyJ0eXBlIjoiaW50ZWdlciIsImZvcm1hdCI6ImludDMyIiwiZGVzY3JpcHRpb24iOiJjYWxscyBwZXIgaG91ciBhbGxvd2VkIGJ5IHRoZSB1c2VyIn19LCJzY2hlbWEiOnsidHlwZSI6InN0cmluZyJ9fSwiNDAwIjp7ImRlc2NyaXB0aW9uIjoiSW52YWxpZCB1c2VybmFtZS9wYXNzd29yZCBzdXBwbGllZCJ9fX19LCIvdXNlci9sb2dvdXQiOnsiZ2V0Ijp7InRhZ3MiOlsidXNlciJdLCJzdW1tYXJ5IjoiTG9ncyBvdXQgY3VycmVudCBsb2dnZWQgaW4gdXNlciBzZXNzaW9uIiwiZGVzY3JpcHRpb24iOiIiLCJvcGVyYXRpb25JZCI6ImxvZ291dFVzZXIiLCJwcm9kdWNlcyI6WyJhcHBsaWNhdGlvbi9qc29uIiwiYXBwbGljYXRpb24veG1sIl0sInBhcmFtZXRlcnMiOltdLCJyZXNwb25zZXMiOnsiZGVmYXVsdCI6eyJkZXNjcmlwdGlvbiI6InN1Y2Nlc3NmdWwgb3BlcmF0aW9uIn19fX0sIi91c2VyIjp7InBvc3QiOnsidGFncyI6WyJ1c2VyIl0sInN1bW1hcnkiOiJDcmVhdGUgdXNlciIsImRlc2NyaXB0aW9uIjoiVGhpcyBjYW4gb25seSBiZSBkb25lIGJ5IHRoZSBsb2dnZWQgaW4gdXNlci4iLCJvcGVyYXRpb25JZCI6ImNyZWF0ZVVzZXIiLCJjb25zdW1lcyI6WyJhcHBsaWNhdGlvbi9qc29uIl0sInByb2R1Y2VzIjpbImFwcGxpY2F0aW9uL2pzb24iLCJhcHBsaWNhdGlvbi94bWwiXSwicGFyYW1ldGVycyI6W3siaW4iOiJib2R5IiwibmFtZSI6ImJvZHkiLCJkZXNjcmlwdGlvbiI6IkNyZWF0ZWQgdXNlciBvYmplY3QiLCJyZXF1aXJlZCI6dHJ1ZSwic2NoZW1hIjp7IiRyZWYiOiIjL2RlZmluaXRpb25zL1VzZXIifX1dLCJyZXNwb25zZXMiOnsiZGVmYXVsdCI6eyJkZXNjcmlwdGlvbiI6InN1Y2Nlc3NmdWwgb3BlcmF0aW9uIn19fX19LCJzZWN1cml0eURlZmluaXRpb25zIjp7ImFwaV9rZXkiOnsidHlwZSI6ImFwaUtleSIsIm5hbWUiOiJhcGlfa2V5IiwiaW4iOiJoZWFkZXIifSwicGV0c3RvcmVfYXV0aCI6eyJ0eXBlIjoib2F1dGgyIiwiYXV0aG9yaXphdGlvblVybCI6Imh0dHBzOi8vcGV0c3RvcmUuc3dhZ2dlci5pby9vYXV0aC9hdXRob3JpemUiLCJmbG93IjoiaW1wbGljaXQiLCJzY29wZXMiOnsicmVhZDpwZXRzIjoicmVhZCB5b3VyIHBldHMiLCJ3cml0ZTpwZXRzIjoibW9kaWZ5IHBldHMgaW4geW91ciBhY2NvdW50In19fSwiZGVmaW5pdGlvbnMiOnsiQXBpUmVzcG9uc2UiOnsidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsiY29kZSI6eyJ0eXBlIjoiaW50ZWdlciIsImZvcm1hdCI6ImludDMyIn0sInR5cGUiOnsidHlwZSI6InN0cmluZyJ9LCJtZXNzYWdlIjp7InR5cGUiOiJzdHJpbmcifX19LCJDYXRlZ29yeSI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJpZCI6eyJ0eXBlIjoiaW50ZWdlciIsImZvcm1hdCI6ImludDY0In0sIm5hbWUiOnsidHlwZSI6InN0cmluZyJ9fSwieG1sIjp7Im5hbWUiOiJDYXRlZ29yeSJ9fSwiUGV0Ijp7InR5cGUiOiJvYmplY3QiLCJyZXF1aXJlZCI6WyJuYW1lIiwicGhvdG9VcmxzIl0sInByb3BlcnRpZXMiOnsiaWQiOnsidHlwZSI6ImludGVnZXIiLCJmb3JtYXQiOiJpbnQ2NCJ9LCJjYXRlZ29yeSI6eyIkcmVmIjoiIy9kZWZpbml0aW9ucy9DYXRlZ29yeSJ9LCJuYW1lIjp7InR5cGUiOiJzdHJpbmciLCJleGFtcGxlIjoiZG9nZ2llIn0sInBob3RvVXJscyI6eyJ0eXBlIjoiYXJyYXkiLCJ4bWwiOnsid3JhcHBlZCI6dHJ1ZX0sIml0ZW1zIjp7InR5cGUiOiJzdHJpbmciLCJ4bWwiOnsibmFtZSI6InBob3RvVXJsIn19fSwidGFncyI6eyJ0eXBlIjoiYXJyYXkiLCJ4bWwiOnsid3JhcHBlZCI6dHJ1ZX0sIml0ZW1zIjp7InhtbCI6eyJuYW1lIjoidGFnIn0sIiRyZWYiOiIjL2RlZmluaXRpb25zL1RhZyJ9fSwic3RhdHVzIjp7InR5cGUiOiJzdHJpbmciLCJkZXNjcmlwdGlvbiI6InBldCBzdGF0dXMgaW4gdGhlIHN0b3JlIiwiZW51bSI6WyJhdmFpbGFibGUiLCJwZW5kaW5nIiwic29sZCJdfX0sInhtbCI6eyJuYW1lIjoiUGV0In19LCJUYWciOnsidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsiaWQiOnsidHlwZSI6ImludGVnZXIiLCJmb3JtYXQiOiJpbnQ2NCJ9LCJuYW1lIjp7InR5cGUiOiJzdHJpbmcifX0sInhtbCI6eyJuYW1lIjoiVGFnIn19LCJPcmRlciI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJpZCI6eyJ0eXBlIjoiaW50ZWdlciIsImZvcm1hdCI6ImludDY0In0sInBldElkIjp7InR5cGUiOiJpbnRlZ2VyIiwiZm9ybWF0IjoiaW50NjQifSwicXVhbnRpdHkiOnsidHlwZSI6ImludGVnZXIiLCJmb3JtYXQiOiJpbnQzMiJ9LCJzaGlwRGF0ZSI6eyJ0eXBlIjoic3RyaW5nIiwiZm9ybWF0IjoiZGF0ZS10aW1lIn0sInN0YXR1cyI6eyJ0eXBlIjoic3RyaW5nIiwiZGVzY3JpcHRpb24iOiJPcmRlciBTdGF0dXMiLCJlbnVtIjpbInBsYWNlZCIsImFwcHJvdmVkIiwiZGVsaXZlcmVkIl19LCJjb21wbGV0ZSI6eyJ0eXBlIjoiYm9vbGVhbiJ9fSwieG1sIjp7Im5hbWUiOiJPcmRlciJ9fSwiVXNlciI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJpZCI6eyJ0eXBlIjoiaW50ZWdlciIsImZvcm1hdCI6ImludDY0In0sInVzZXJuYW1lIjp7InR5cGUiOiJzdHJpbmcifSwiZmlyc3ROYW1lIjp7InR5cGUiOiJzdHJpbmcifSwibGFzdE5hbWUiOnsidHlwZSI6InN0cmluZyJ9LCJlbWFpbCI6eyJ0eXBlIjoic3RyaW5nIn0sInBhc3N3b3JkIjp7InR5cGUiOiJzdHJpbmcifSwicGhvbmUiOnsidHlwZSI6InN0cmluZyJ9LCJ1c2VyU3RhdHVzIjp7InR5cGUiOiJpbnRlZ2VyIiwiZm9ybWF0IjoiaW50MzIiLCJkZXNjcmlwdGlvbiI6IlVzZXIgU3RhdHVzIn19LCJ4bWwiOnsibmFtZSI6IlVzZXIifX19LCJleHRlcm5hbERvY3MiOnsiZGVzY3JpcHRpb24iOiJGaW5kIG91dCBtb3JlIGFib3V0IFN3YWdnZXIiLCJ1cmwiOiJodHRwOi8vc3dhZ2dlci5pbyJ9fQ==

An APIServiceInstance will hold the endpoints where an APIServiceRevision is exposed.

kind: APIServiceInstance
name: petstore
metadata:
  scope:
    kind: Environment
    name: vibu
spec:
  apiServiceRevision: petstore
  endpoint:
    - host: "petstore.com"
      port: 443
      protocol: https
      routing:
        basePath: "/v1"
amplify central apply -f /tmp/env.yaml
amplify central apply -f /tmp/apisvc.yaml
amplify central apply -f /tmp/apiservicerev.yaml
amplify central apply -f /tmp/apiserviceins.yaml

A SubscriptionDefinition specifies what params are needed from a consumer to subscribe.

A ConsumerInstance publishes an APIServiceInstance as a catalog item. It can optionally link a SubscriptionDefinition to enable subscribing on the catalog item.

apiVersion: v1alpha1
kind: ConsumerSubscriptionDefinition
name: subsdef
metadata:
  scope:
    kind: Environment
    name: vibu
spec:
  schema:
    properties:
      - key: profile
        value: 
          type: object
          properties:
            param1:
              type: string
---
apiVersion: v1alpha1
kind: ConsumerInstance
name: consumerinst1
title: consumerinst1 title
metadata:
  scope:
    kind: Environment
    name: vibu
tags:
- cli
- consumerinst
spec:
  name: Consumer Instance Name
  apiServiceInstance: petstore
  description: My petstore
  visibility: RESTRICTED
  version: "1.0"
  state: PUBLISHED
  status: statusValue
  tags:
  - instance
  - cli
  documentation: Petstore api
  subscription:
    enabled: true
    subscriptionDefinition: subsdef
    autoSubscribe: false

Once the ConsumerInstance is created you should see a CatalogItem in Catalog and be able to subscribe.

amplify central apply -f /tmp/consinst.yaml

Step by step api exposing with api-key auth and acl plugin

First create a service to represent your backend

POST http://localhost:8001/services
Content-Type: application/json

{
"name": "httpbin",
"url": "http://httpbin.org"
}

Create a route to expose the service via kong.

POST http://localhost:8001/services/httpbin/routes
Content-Type: application/json

{
"name": "httpbin",
"paths": ["/httpbin"],
"hosts": ["localhost"]
}

At this point the service should be available

GET http://localhost:8000/httpbin/get

Add the key-auth auth plugin to the route.

POST http://localhost:8001/routes/httpbin/plugins
Content-Type: application/json

{
"name": "key-auth"
}

At this point you should get a 401

GET http://localhost:8000/httpbin/get

To access the api you'd need to create a consumer.

POST http://localhost:8001/consumers
Content-Type: application/json

{
"username": "vbuciuc"
}

And then create a credential for the consumer:

POST http://localhost:8001/consumers/vbuciuc/key-auth
Content-Type: application/json

{}

At this point you should be able to access the api again by putting the api-key as an url parameter.

GET http://localhost:8000/httpbin/get?apikey=YThJ3CHDTkHgmETG49u5J9uwQmiek8oM

Continuing with ACL, first add the plugin on the route.

POST http://localhost:8001/routes/httpbin/plugins
Content-Type: application/json

{
"name": "acl",
"config": {"allow": ["httpbin.subscribers"]}
}

After this you'll get an Unauthorized response even if you pass the right apikey.

GET http://localhost:8000/httpbin/get?apikey=YThJ3CHDTkHgmETG49u5J9uwQmiek8oM

Add the consumer to the right acl group

POST http://localhost:8001/consumers/vbuciuc/acls
Content-Type: application/x-www-form-urlencoded

group=httpbin.subscribers

GET http://localhost:8000/httpbin/get?apikey=YThJ3CHDTkHgmETG49u5J9uwQmiek8oM

Any api with the key-auth plugin will be accessible unless it also has the acl plugin

New service for petstore.

POST :aurl/services
Content-Type: application/json

{
 "name": "petstore",
 "url": "http://petstore.swagger.io/v2"
}

New route to expose it:

POST http://localhost:8001/services/petstore/routes
Content-Type: application/json

{
"name": "petstore",
"paths": ["/petstore"],
"hosts": ["localhost"]
}

Add an key-auth plugin:

POST :aurl/routes/petstore/plugins
Content-Type: application/json

{
"name": "key-auth"
}

It should be accesible by the previously created consumer since it already has an api-key

GET http://localhost:8000/petstore/store/inventory?apikey=YThJ3CHDTkHgmETG49u5J9uwQmiek8oM

But add the acl:

POST http://localhost:8001/routes/petstore/plugins
Content-Type: application/json

{
"name": "acl",
"config": {"allow": ["petstore.subscribers"]}
}

And you won't be able to access it anymore:

GET http://localhost:8000/petstore/store/inventory?apikey=YThJ3CHDTkHgmETG49u5J9uwQmiek8oM
Clone this wiki locally