Skip to content
Kong Logo | Kong Docs Logo
search
  • We're Hiring!
  • Docs
    • Kong Gateway
    • Kong Konnect
    • Kong Mesh
    • Plugin Hub
    • decK
    • Kubernetes Ingress Controller
    • Insomnia
    • Kuma

    • Docs contribution guidelines
  • Plugin Hub
  • Support
  • Community
  • Kong Academy
Get a Demo Start Free Trial
  • Kong Gateway
  • Kong Konnect
  • Kong Mesh
  • Plugin Hub
  • decK
  • Kubernetes Ingress Controller
  • Insomnia
  • Kuma

  • Docs contribution guidelines
    • Overview of Konnect
    • Architecture
    • Network Resiliency and Availability
    • Port and Network Requirements
    • Compatibility
    • Stages of Software Availability
    • Release Notes
      • Control Plane Upgrades FAQ
      • Supported Installation Options
    • Overview
    • Access a Konnect Account
    • Set up a Runtime
    • Configure a Service
    • Implement and Test the Service
      • Publish and Consume Services
      • Register Applications
    • Import Kong Gateway Entities into Konnect
    • Overview
      • Overview
      • Dashboard
      • Manage Runtime Groups with UI
      • Manage Runtime Groups with decK
      • Installation Options
      • Install with Docker
      • Install on Kubernetes
      • Install on Linux
      • Install on AWS
      • Install on Azure
      • Upgrade a Runtime Instance to a New Version
      • Renew Certificates
      • Runtime Parameter Reference
    • Create Consumer Groups
      • Overview
      • Set Up and Use a Vault in Konnect
    • Kong Gateway Configuration in Konnect
    • Plugin Ordering Reference
    • Troubleshoot
    • Overview
    • Manage Service Documentation
      • Overview
      • Configure a Plugin on a Service
      • Configure a Plugin on a Route
    • Overview
    • Access the Dev Portal
    • Sign Up for a Dev Portal Account
      • Manage Developer Access
      • Manage Application Registration Requests
      • Manage Application Connections
      • Auto Approve Dev and App Registrations
      • Azure OIDC
      • Application Overview
      • Enable and Disable App Registration
        • Overview
        • Okta
        • Curity
        • Auth0
      • Create, Edit, and Delete an Application
      • Register an Application with a Service
      • Generate Credentials for an Application
    • Customize Dev Portal
    • Troubleshoot
    • Introduction to Analytics
    • Analyze Services and Routes
    • Reports Use Cases
    • Reports Reference
    • Troubleshoot
      • Manage a Konnect Account or Plan
      • Change to a Different Plan
      • Manage Payment Methods and Invoices
      • Overview
        • Overview
        • Manage Teams
        • Teams Reference
        • Roles Reference
      • Manage Users
      • Manage System Accounts
      • Set up SSO with OIDC
      • Set up SSO with Okta
      • Login Sessions Reference
    • Account and Org Deactivation
    • Troubleshoot
    • Overview
      • API Documentation
      • Identity Integration Guide
      • API Documentation
      • API Documentation
      • Portal RBAC Guide
      • Overview
      • Nodes
      • Data Plane Certificiates
        • Services
        • Routes
        • Consumers
        • Plugins
        • Upstreams
        • Certificates
        • CA Certificates
        • SNIs
        • Targets
        • Vaults
      • API Spec
      • Filtering
    • Labels

github-edit-pageEdit this page

report-issueReport an issue

enterprise-switcher-iconSwitch to OSS

On this page
  • Prerequisites
  • Create a service
  • Create a service version
  • Summary and next steps
Kong Konnect
  • Home
  • Kong Konnect
  • Getting Started
  • Configuring a Service

Configuring a Service

Using the Service Hub, you can create, manage, and implement Konnect services. Each service consists of at least one service version, and each service version can have one implementation.

Konnect service diagram

For the purpose of this guide, you’ll create a service, version it, and expose the version by creating an implementation pointing to the Mockbin API. Mockbin is an echo-type public website that returns requests back to the requester as responses.

Prerequisites

If you’re following the Konnect quickstart guide, make sure you have configured a runtime.

Create a service

  1. From the left navigation menu, open servicehub icon Service Hub.

  2. Click New service.

  3. Enter a display name. For this example, enter example_service.

    A display name can be any string containing letters, numbers, spaces, or the following characters: ., -, _, ~, or :. Spaces are equal to the - character.

    For example, you can use example_service, ExampleService, Example-Service, or Example Service. Example-Service and Example Service would be considered the same name.

    The display name you create generates a service name. Konnect uses the service name for internal metadata.

  4. (Optional) Enter a description.

    This description is used in Konnect and on the Dev Portal.

  5. Click Create.

    You can now see your new service’s overview page.

    Now that you have a service set up, you can start filling out details about your API.

Create a service version

Let’s set up the first version of your API service.

  1. In the servicehub icon Service Hub, open the example_service service and click Service actions > Add new version.

  2. Enter a version name. For this example, enter v1.

    A version name can be any string containing letters, numbers, or characters; for example, 1.0.0, v1, or version#1. A service can have multiple versions.

  3. Select a runtime group.

    Choose a group to deploy this service version to. This lets you deploy to a specific group of runtime instances in a specific environment.

    Note: Application registration is only available for services in the default runtime group, so if you plan on using application registration, choose default in this step.

    Different versions of the same service can run in different runtime groups. The version name is unique within a group:

    • If you create multiple versions in the same group, they must have unique names.
    • If you create multiple versions in different groups, the versions can have the same name.
  4. Click Save.

Summary and next steps

In this section, you added a service named example_service with the version v1.

Next, go on to implement the service version.

Thank you for your feedback.
Was this page useful?
  • Kong
    THE CLOUD CONNECTIVITY COMPANY

    Kong powers reliable digital connections across APIs, hybrid and multi-cloud environments.

    • Company
    • Customers
    • Events
    • Investors
    • Careers Hiring!
    • Partners
    • Press
    • Contact
  • Products
    • Kong Konnect
    • Kong Gateway
    • Kong Mesh
    • Get Started
    • Pricing
  • Resources
    • eBooks
    • Webinars
    • Briefs
    • Blog
    • API Gateway
    • Microservices
  • Open Source
    • Install Kong Gateway
    • Kong Community
    • Kubernetes Ingress
    • Kuma
    • Insomnia
  • Solutions
    • Decentralize
    • Secure & Govern
    • Create a Dev Platform
    • API Gateway
    • Kubernetes
    • Service Mesh
Star
  • Terms•Privacy
© Kong Inc. 2023