Skip to content

Commit

Permalink
Merge pull request #11 from FraunhoferIOSB/development
Browse files Browse the repository at this point in the history
Merge development into staging
  • Loading branch information
ralfaron authored Jan 7, 2024
2 parents 1cf0c99 + 196820f commit 3662ca2
Show file tree
Hide file tree
Showing 52 changed files with 3,900 additions and 9,392 deletions.
8 changes: 2 additions & 6 deletions .github/workflows/versioning-workflow.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,16 +14,12 @@ jobs:
release:
name: Versioning
runs-on: ubuntu-latest
permissions:
contents: write # to be able to publish a GitHub release
issues: write # to be able to comment on released issues
pull-requests: write # to be able to comment on released pull requests
id-token: write # to enable use of OIDC for npm provenance
steps:
- name: Checkout
uses: actions/checkout@v3
with:
fetch-depth: 0
persist-credentials: false
- name: Setup Node.js
uses: actions/setup-node@v3
with:
Expand All @@ -34,5 +30,5 @@ jobs:
run: npm audit signatures
- name: Release
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
GH_TOKEN: ${{ secrets.GH_TOKEN }}
run: npx semantic-release
1 change: 0 additions & 1 deletion .releaserc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@
["@semantic-release/npm", {
"npmPublish": false
}],
["@semantic-release/github"],
["@semantic-release/git", {
"assets": ["package.json"],
"message": "chore(Release): ${nextRelease.version}\n\n${nextRelease.notes}"
Expand Down
3 changes: 2 additions & 1 deletion Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,8 @@
FROM node:lts-alpine3.16 as build
WORKDIR /usr/src/app
COPY . .
RUN npm install -w=aas-server -w=aas-portal
RUN apk add g++ make py3-pip
RUN npm install
RUN node create-app-info.js
RUN npm run build

Expand Down
2 changes: 1 addition & 1 deletion Dockerfile.aas-portal
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
FROM node:lts-alpine3.16 as build
WORKDIR /usr/src/app
COPY . .
RUN npm ci -w=aas-portal
RUN npm install
RUN npm run aas-portal:build

FROM nginx:latest as aas-portal
Expand Down
2 changes: 1 addition & 1 deletion Dockerfile.aas-server
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
FROM node:lts-alpine3.16 as build
WORKDIR /usr/src/app
COPY . .
RUN npm install -w=aas-server
RUN npm install
RUN node create-app-info.js
RUN npm run aas-server:build

Expand Down
17 changes: 11 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,29 @@
# AASPortal [![Documentation Status](https://readthedocs.org/projects/aasportal/badge/?version=latest "Documentation Status")](https://aasportal.readthedocs.io/en/latest/?badge=latest)

![AASPortal Logo <](./docs/source/images/AASPortal_mid.png "AASPortal Logo")
**AASPortal** is a Node.js based web portal for the visualization and management of Asset Administration Shells (AAS). The implementation uses the concepts of the document "Details of the Asset Administration Shell" published on https://www.plattform-i40.de and licensed under Creative Commons CC BY 4.0.

**AASPortal** is a Node.js based web portal for the visualization and management of Asset Administration Shells (AAS). The implementation uses the concepts of the document "Details of the Asset Administration Shell" published on https://www.plattform-i40.de and licensed under Creative Commons CC BY 4.0.
Check out the [Getting Started](./docs/source/gettingstarted.md) section to learn how to setup Visual Studio Code and start using and developing the *AASPortal*. Learn more about the [Architecture](./docs/source/architecture.md) of *AASPortal*, and check out the [Usage](./docs/source/usage.md) section to learn about available search filters for AAS and which Endpoints can be connected to the *AASPortal*.

For more details about the AASPortal see the full documentation :blue_book: [here](https://aasportal.readthedocs.io/en/latest/?badge=latest).
**AASPortal is under active development and we are looking forward to your active contributions!**

## Prerequisites
- Visual Studio Code
- Node.js v18.10.0
- GIT 2.36.0.windows
- Docker Desktop 4.x
- Docker Desktop 4.x

## Getting Started
You can find a detailed documentation :blue_book: [here](https://aasportal.readthedocs.io/)

## Usage
### Dockerhub

The easiest way to run AASPortal locally, is using the latest "all in one" image from Dockerhub:

`docker run -p 80:80 fraunhoferiosb/aasportal_aio`

Then go to http://localhost/ in your browser and enjoy.

### Setup Visual Studio Code
The preferred development environment is Visual Studio Code. Clone *AASPortal*'s GIT repository. Open aasportal in Visual Studio Code. In a terminal window execute the the following commands:
Expand All @@ -34,9 +41,7 @@ The following command creates and executes a Docker image:

`npm run start`

Go to:

http://localhost/
Go to: http://localhost/

## Changelog

Expand Down
11 changes: 10 additions & 1 deletion docs/source/gettingstarted.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,13 @@ aasportal
```

## Docker(hub)
The easiest way to run AASPortal locally, is using the latest "all in one" image from Dockerhub:

`docker run -p 80:80 fraunhoferiosb/aasportal_aio`

Then go to http://localhost/ in your browser and enjoy.

## Setup Visual Studio Code
The preferred development environment is Visual Studio Code. Clone *AASPortal*'s GIT repository. Open aasportal in Visual Studio Code. In a terminal window execute the the following commands:

Expand Down Expand Up @@ -63,7 +70,9 @@ or the name (idShort) of the AAS
http://localhost/?id=Bosch_NexoPistolGripNutrunner

## AASServer
ToDo.
AASServer is a Node.js server application based on the Express framework. The main feature of AASServer is the provision of Asset Administration Shells from different data sources (AASX server, OPC UA server, file system). AASServer can read Asset Administration Shells in JSON, XML and OPC UA format. An Asset Administration Shell is always provided to a web client (AASPortal) in JSON version 3 format.

AASServer provides a user management. Authentication of a user is based on Json Web Token.

## Environment Variables
| Name | | default |
Expand Down
2 changes: 1 addition & 1 deletion docs/source/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

Check out the [Getting Started](gettingstarted.md) section to learn how to setup Visual Studio Code and start using and developing the *AASPortal*. Learn more about the [Architecture](architecture.md) of *AASPortal*, and check out the [Usage](usage.md) section to learn about available search filters for AAS and which Endpoints can be connected to the *AASPortal*.

*This project is under active development and we are looking forward to your active contributions!*
*This project is under active development and we are looking forward to your active contributions!!*

```{toctree}
:hidden:
Expand Down
Loading

0 comments on commit 3662ca2

Please sign in to comment.