Smart Supermarket Tutorials

This is a collection of tutorials for the FIWARE ecosystem designed for NGSI-v2 developers. Each tutorial consists of a series of exercises to demonstrate the correct use of individual FIWARE components and shows the flow of context data within a simple Smart Solution either by connecting to a series of dummy IoT devices or manipulating the context directly or programmatically.

📚 NGSI-v2 Documentation	Postman Collections		developer.fiware.org

🇯🇵 このチュートリアルは日本語でもご覧いただけます。

Note

Should I use NGSI-v2 or NGSI-LD?

FIWARE offers two flavours of the NGSI interfaces:

NGSI-v2 offers JSON based interoperability used in individual Smart Systems
NGSI-LD offers JSON-LD based interoperability used for Federations and Data Spaces

NGSI-v2 is ideal for creating individual applications offering interoperable interfaces for web services or IoT devices. It is easier to understand than NGSI-LD and does not require a JSON-LD @context

However, NGSI-LD and Linked Data is necessary when creating a data space or introducing a system of systems aproach, and in situations requiring interoperability across apps and organisations.

More information about NGSI-LD can be found here

Data models

The following NGSI-v2 and NGSI-LD Data models are used within the tutorials:

Install

To download the full set of tutorials, simply clone this repository:

git clone https://github.com/FIWARE/tutorials.NGSI-v2.git
cd tutorials.NGSI-v2/
git submodule update --init --recursive

Docker and Docker Compose

The NGSI-v2 tutorials are designed to run under any Unix environment, the tested configuration and GitPod environment is currently based on Ubuntu 22.04.2 LTS. However, there may be some minor issues when running the tutorials directly on Windows machines or Apple M1 Silicon amd64 systems, and the following Virtual Box set-up or WSL set-up can be used when facing issues.

Each tutorial runs all components using Docker. Docker is a container technology which allows to different components isolated into their respective environments.

To install Docker on Windows follow the instructions here
To install Docker on Mac follow the instructions here
To install Docker on Linux follow the instructions here

Docker Compose is a tool for defining and running multi-container Docker applications. A series of *.yaml files are used configure the required services for the application. This means all container services can be brought up in a single command. Docker Compose is installed by default as part of Docker for Windows and Docker for Mac, however Linux users will need to follow the instructions found here

You can check your current Docker and Docker Compose versions using the following commands:

docker-compose -v
docker version

Please ensure that you are using Docker version 24.0.x or higher and Docker Compose 2.24.x or higher and upgrade if necessary.

Postman

The tutorials which use HTTP requests supply a collection for use with the Postman utility. Postman is a testing framework for REST APIs. The tool can be downloaded from www.postman.com. All the FIWARE Postman collections can be downloaded directly from the Postman API network

GitPod

Gitpod is an open-source Kubernetes application for ready-to-code cloud development environments that spins up an automated dev environment for each task, in the cloud. It enables you to run the tutorials in a cloud development environment directly from your browser or your Desktop IDE.

Apache Maven

Apache Maven is a software project management and comprehension tool. Based on the concept of a project object model (POM), Maven can manage a project's build, reporting and documentation from a central piece of information. Maven can be used to define and download our dependencies and to build and package Java or Scala code into a JAR file.

Windows Subsystem for Linux

We will start up our services using a simple bash script. Windows users should download the Windows Subsystem for Linux to provide a command-line functionality similar to a Linux distribution on Windows.

Tutorials List

Usage

Most tutorials supply a services script to start the containers:

cd <tutorial-name>
./services start

Following the tutorial exercises via Postman

Each tutorial submodule contains one or more docker-compose.yml files, along with a Postman collection containing the necessary HTTP requests: import the collection into Postman and follow the instructions.

Following the tutorial exercises from the command-line

Each submodule contains full instructions in README which details the appropriate bash commands (cUrl and Docker Compose) to run.

Full instructions can be found within the documentation

Name		Name	Last commit message	Last commit date
Latest commit History 888 Commits
.github		.github
.husky		.husky
context-provider		context-provider
docker		docker
docs		docs
tutorials.Accessing-Context @ 3817863		tutorials.Accessing-Context @ 3817863
tutorials.Administrating-XACML @ fa46dba		tutorials.Administrating-XACML @ fa46dba
tutorials.Application-Mashup @ b4fd0d9		tutorials.Application-Mashup @ b4fd0d9
tutorials.Big-Data-Flink @ 7c9d59e		tutorials.Big-Data-Flink @ 7c9d59e
tutorials.Big-Data-Spark @ 50e6e44		tutorials.Big-Data-Spark @ 50e6e44
tutorials.CRUD-Operations @ 889dbff		tutorials.CRUD-Operations @ 889dbff
tutorials.Context-Providers @ 107984c		tutorials.Context-Providers @ 107984c
tutorials.Custom-IoT-Agent @ 305111c		tutorials.Custom-IoT-Agent @ 305111c
tutorials.Edge-Computing @ 14ed7b7		tutorials.Edge-Computing @ 14ed7b7
tutorials.Entity-Relationships @ bb0bce8		tutorials.Entity-Relationships @ bb0bce8
tutorials.Getting.Started @ d58837a		tutorials.Getting.Started @ d58837a
tutorials.Historic-Context-Flume @ 864b60c		tutorials.Historic-Context-Flume @ 864b60c
tutorials.Historic-Context-NIFI @ aabe1aa		tutorials.Historic-Context-NIFI @ aabe1aa
tutorials.Identity-Management @ 3a3ceb6		tutorials.Identity-Management @ 3a3ceb6
tutorials.IoT-Agent @ 25bbdd4		tutorials.IoT-Agent @ 25bbdd4
tutorials.IoT-Agent-JSON @ 3903c48		tutorials.IoT-Agent-JSON @ 3903c48
tutorials.IoT-Sensors @ 52f3997		tutorials.IoT-Sensors @ 52f3997
tutorials.IoT-over-IOTA @ d909a1c		tutorials.IoT-over-IOTA @ d909a1c
tutorials.IoT-over-MQTT @ 9d428ea		tutorials.IoT-over-MQTT @ 9d428ea
tutorials.LD-Subscriptions-Registrations @ 43dee8f		tutorials.LD-Subscriptions-Registrations @ 43dee8f
tutorials.Linked-Data @ 10d303c		tutorials.Linked-Data @ 10d303c
tutorials.Media-Streams @ 2feb3e8		tutorials.Media-Streams @ 2feb3e8
tutorials.PEP-Proxy @ dde1fd7		tutorials.PEP-Proxy @ dde1fd7
tutorials.Relationships-Linked-Data @ 0f49470		tutorials.Relationships-Linked-Data @ 0f49470
tutorials.Roles-Permissions @ 86b1375		tutorials.Roles-Permissions @ 86b1375
tutorials.Securing-Access @ ad63029		tutorials.Securing-Access @ ad63029
tutorials.Securing-Access-OpenID-Connect @ a614ac4		tutorials.Securing-Access-OpenID-Connect @ a614ac4
tutorials.Short-Term-History @ 86eea10		tutorials.Short-Term-History @ 86eea10
tutorials.Subscriptions @ 04db254		tutorials.Subscriptions @ 04db254
tutorials.Time-Series-Data @ 004933f		tutorials.Time-Series-Data @ 004933f
tutorials.Working-with-Linked-Data @ a1cf6a6		tutorials.Working-with-Linked-Data @ a1cf6a6
tutorials.XACML-Access-Rules @ 1d80116		tutorials.XACML-Access-Rules @ 1d80116
.dockerignore		.dockerignore
.gitignore		.gitignore
.gitmodules		.gitmodules
.readthedocs.yml		.readthedocs.yml
.remarkrc		.remarkrc
.textlintrc		.textlintrc
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
mkdocs.yml		mkdocs.yml
package.json		package.json

License

FIWARE/tutorials.NGSI-v2

Folders and files

Latest commit

History

Repository files navigation

Smart Supermarket Tutorials

Data models

Install

Docker and Docker Compose

Postman

GitPod

Apache Maven

Windows Subsystem for Linux

Tutorials List

Core Context Management: NGSI-v2 Fundamentals

Internet of Things, Robots and third-party systems

Core Context Management: Manipulating Context Data and Persisting Historic Data

Security: Identity Management

Processing, Analysis and Visualization

NGSI-LD for NGSI-v2 Developers

Usage

Following the tutorial exercises via Postman

Following the tutorial exercises from the command-line

License

About

Topics

Resources

License

Stars

Watchers

Forks

Languages