73 lines
1.6 KiB
Markdown
73 lines
1.6 KiB
Markdown
|
# instructions
|
||
|
|
|
||
|
|
## project structure
|
||
|
|
|
||
|
|
├── .gitignore
|
||
|
|
├── pom.xml
|
||
|
|
├── src
|
||
|
|
│ └── ***
|
||
|
|
├── gcube/
|
||
|
|
│ └── extra-resources/
|
||
|
|
│ └── WEB-INF/
|
||
|
|
│ ├── application.yaml
|
||
|
|
│ └── web.xml
|
||
|
|
|
||
|
|
# optional, for local develop in docker containers
|
||
|
|
├── docker/
|
||
|
|
│ ├── ontainer.ini
|
||
|
|
│ └── logback.xml
|
||
|
|
├── docker-compose.yaml
|
||
|
|
└── Dockerfile
|
||
|
|
|
||
|
|
|
||
|
|
### file details
|
||
|
|
* gitignore: gitignore file for java projects
|
||
|
|
|
||
|
|
* pom.xml
|
||
|
|
* <parent>: maven-parent configuration. currently 1.2.0 version
|
||
|
|
* <properties><webappDirectory> : path for web.xml
|
||
|
|
* <scm> ???
|
||
|
|
* <dependencyManagement> gcube dependency manager
|
||
|
|
|
||
|
|
* docker/container.ini: configurations for the docker container.
|
||
|
|
* mode: [online/offline]: register the service on IS. use offline for local docker instances
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
# EXCECUTION
|
||
|
|
|
||
|
|
start the docker container
|
||
|
|
```./buildImageAndStart.sh```
|
||
|
|
|
||
|
|
test urls (replace {{TOKEN}} with your token):
|
||
|
|
|
||
|
|
|
||
|
|
http://localhost:8081/helloworld/guest
|
||
|
|
|
||
|
|
http://localhost:8080/helloworld/details?gcube-token={{TOKEN}}
|
||
|
|
http://localhost:8080/helloworld/hello/details?gcube-token={{TOKEN}}
|
||
|
|
|
||
|
|
http://localhost:8080/helloworld/auth?gcube-token={{TOKEN}} (checks for myRole role)
|
||
|
|
http://localhost:8080/helloworld/auth/orm_member?gcube-token={{TOKEN}} (checks for OrganizationMember role)
|
||
|
|
|
||
|
|
|
||
|
|
### Authentication:
|
||
|
|
|
||
|
|
#### GCUBE-TOKEN param
|
||
|
|
|
||
|
|
obtain personal token at https://next.dev.d4science.org/group/gcube/home
|
||
|
|
|
||
|
|
add
|
||
|
|
|
||
|
|
|
||
|
|
### DEBUG
|
||
|
|
|
||
|
|
start the docker container in debug Mode
|
||
|
|
```./buildImageAndStartWithDebug.sh```
|
||
|
|
|
||
|
|
connect the JAVA debugger to port 5005
|
||
|
|
|
||
|
|
* VSCODE: press the green play button and start "Debug (Attach)
|
||
|
|
|
||
|
|
|