README.md

Using/Testing the webmethods-devportal-configurator

I have prepared most actions into a simple docker-compose file to:

• Demonstrate how to use
• Verify behavior
• Act as a rudimental (but accurate) documentation

The product images used in this testing are the official SoftwareAG images for Developper Portal so this should be a breeze to try.

Start default SoftwareAG API management stack

Here, we're pulling the default container images by SoftwareAG from DockerHub, ie. IMAGE_DEVPORTAL=softwareag/devportal

Check the .env for more details on that.

docker-compose up -d devportal elasticsearch

Wait for the stack to come up...once loaded, the UIs shoudl be available:

• Developer Portal: http://localhost:8083/portal/

You can login with default passwords etc... and nothing is configured at this point.

All-in-one: Apply all system configs and all sample data in 1 batch

Here we're applying it all in 1 single configurator batch...which could be the possible way to do it in an automated environment.

docker-compose up -d config_allinone

Manual apply: execute each system configs one at a time

configure load balancer url

docker-compose up config_loadbalancer_url

update password

docker-compose up changepassword

save or update users

docker-compose up config_users

save or update user groups

docker-compose up config_usergroups

save or update teams

docker-compose up config_teams

Clean up

docker-compose down -v

Configure saml

For this one, since it involves more external components specific to SAML (ie. keycloak IDP), we created a specific compose file

Simply run:

docker-compose -f docker-compose-saml.yml up -d

Cleanup:

docker-compose -f docker-compose-saml.yml down -v

Authors

Fabien Sanglier

• Emails: @Software AG // @Software AG Government Solutions
• Github:
  • Fabien Sanglier
  • Fabien Sanglier @ SoftwareAG Government Solutions

Licensing - Apache-2.0

This project is Licensed under the Apache License, Version 2.0 (the "License"); You may not use this project except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.