Skip to content

oracle-devrel/oci-serverless

OCI Serverless Samples Repository

License: UPL Quality gate

Welcome to the OCI Serverless Samples Repository!

👋 Introduction

This repository contains curated examples, code snippets, sample architectures and best practices for building serverless solutions on Oracle Cloud Infrastructure (OCI). Whether you’re new to OCI serverless or looking for production-ready patterns, our samples help you get started and succeed.

This initiative supports our strategic goal of simplifying cloud migration and accelerating OCI adoption by providing hands-on resources that expedites the learning curve and improve customer and user experience.

📦 What’s Inside

Explore a variety of practical resources, including:

  • Oracle Functions (Fn Project): Examples in Python, Node.js, Java, and more.
  • OCI Queues & Events Service: Samples for message/event-driven automation and integration.
  • API Gateway: Blueprints for creating serverless REST APIs and securely exposing functions.
  • Serverless Workflows: Pattern examples combining Functions, Events, and other services.
  • Logging: Examples of Function integration with logging

📂 Repository Structure


oci-serverless-samples/
│
├── <serverless services/integrations>/
│ ├── functions/
│ └── terraform/
├── terraform/
│ └── modules/
└── README.md

This structure would evolve potentially as more samples are added.

🏁 Getting Started

Browse Samples Navigate to directories under the respective service/integration folders - functions, api-gateway, queue, logging, and events.

Deploy a Sample
Each sample includes a README.md with deployment instructions. Many samples use the OCI SDK and terraform modules.

Learn More
Review best-practices for insights on security, cost, and operations.

🛠 Prerequisites

Before using the samples in this repository, ensure you have the following:

  • Oracle Cloud Account: Access to an OCI tenancy .
  • User Permissions: Sufficient IAM policies to create and invoke Functions, configure API Gateway, and use related OCI services.
  • Docker: Docker installed (for building and deploying functions).
  • OCI SDKs: SDKs to build and deploy apps that integrate with Oracle Cloud Infrastructure services.
  • Terraform: For infrastructure as code deployments (Terraform OCI Provider).
  • OCI CLI (optional): Oracle Cloud Infrastructure CLI installed and configured.
  • Check each sample’s directory for any additional or sample-specific prerequisites.

📝 Notes

  • These samples are intended for educational, demonstration, and proof-of-concept use.
  • Review all code and configurations for security and compliance requirements before using in production environments.
  • Some samples potentially incur charges in OCI (e.g., API Gateway, Functions, or network usage). Monitor your tenancy usage and costs.
  • For sample-specific limitations or tips, check the individual sample’s README in its folder.

🌐 Useful Links

🤝 Contributing

This project welcomes and appreciates contributions from the community. Before submitting a pull request, please review our contribution guide.

Security

Please consult the security guide for our responsible security vulnerability disclosure process.

License

Copyright (c) 2026 Oracle and/or its affiliates.

Licensed under the Universal Permissive License (UPL), Version 1.0.

See LICENSE for more details.

ORACLE AND ITS AFFILIATES DO NOT PROVIDE ANY WARRANTY WHATSOEVER, EXPRESS OR IMPLIED, FOR ANY SOFTWARE, MATERIAL OR CONTENT OF ANY KIND CONTAINED OR PRODUCED WITHIN THIS REPOSITORY, AND IN PARTICULAR SPECIFICALLY DISCLAIM ANY AND ALL IMPLIED WARRANTIES OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE. FURTHERMORE, ORACLE AND ITS AFFILIATES DO NOT REPRESENT THAT ANY CUSTOMARY SECURITY REVIEW HAS BEEN PERFORMED WITH RESPECT TO ANY SOFTWARE, MATERIAL OR CONTENT CONTAINED OR PRODUCED WITHIN THIS REPOSITORY. IN ADDITION, AND WITHOUT LIMITING THE FOREGOING, THIRD PARTIES MAY HAVE POSTED SOFTWARE, MATERIAL OR CONTENT TO THIS REPOSITORY WITHOUT ANY REVIEW. USE AT YOUR OWN RISK.

About

Sample serverless architectures and code examples for Oracle Cloud Infrastructure (OCI) using Functions, API Gateway, Events, Queues, and Terraform

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors