castlemock / docker Goto Github PK

License: Apache License 2.0

Dockerfile 91.27% Shell 8.73%

docker's Introduction

Castle Mock: Official Docker image

About

Castle Mock is a web application that provides the functionality to mock out RESTful APIs and SOAP web services. This functionality allows client-side developers to completely mimic a server side behaviour and shape the responses themselves.

Castle Mock enables you to upload both WSDL or WADL files. The web services defined within the files will be mocked automatically by Castle Mock. Once the mocks for the web services are created, they can be configured to mock the service or forward the request to the original endpoint. The response from the forwarded requests can be recorded automatically and used to create new mocked responses.

Castle Mock is completely free and open source (Apache License). It is built with Java and the application itself is deployed to an Apache Tomcat server.

Usage

Start Castle Mock by running the following command:

docker run -d -p 8080:8080 castlemock/castlemock

Castle Mock is now accessible from the following IP address:

http://{CONTAINER IP}:8080/castlemock

Persistence

The data files created by Castle Mock can be accessed and stored outside the Docker container. In order to achieve this, you need to create a new volume. This is done by using the -v flag. Run the following command to store Castle Mock's data files in the directory your currenty at.

docker run -d -p 8080:8080 -v $(pwd):/root/.castlemock castlemock/castlemock

Downloads

Non-source downloads such as WAR files can be found on our website: https://www.castlemock.com/.

Source

Our latest and greatest source of Castle Mock can be found on GitHub.

Communication

Bugs and Feedback

For bugs, questions and discussions please use the GitHub Issues

Continuous integration

Castle Mock' continuous integration environment is publicly available and can be access on the following link: Travis CI

News and Website

All information about Castle Mock can be found on our website. Follow us on Twitter: castlemock.

License

Castle Mock is licensed under the Apache License. The terms of the license are as follows:

Apache License

Copyright 2015 Karl Dahlgren and a number of other contributors.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file 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.

docker's People

Contributors

Stargazers

Watchers

Forkers

geraldsp softandbyte amduser trulex jorfao fnkr toniiiik galak06 mamsene arulclinton

docker's Issues

Error 500 when sending request

Hi,

I created a project in castlemock and loaded this WSDL file
https://www.ibm.com/docs/en/api-connect/saas?topic=api-example-wsdl-file-globalweatherwsdl

Every time I try to send a request it gets a 500 error.

The same with the launch of endpoint, among other things:
http://localhost:8080/castlemock/mock/soap/project/C2tc3o/GlobalWeatherSoap12

It gets this error:

How to fix it?

Build tags on docker hub

Thanks for this cool project. Would it be possible to create docker builds on docker hub with tags corresponding to the source tags?

Docker tag v1.61 try to download v1.62/castlemock.war not exist

Hello

The tag v1.61 updated recently to use https://github.com/castlemock/castlemock/releases/download/v1.62/castlemock.war which currently not released yet.

I think it's better to keep tag v1.61 use matched release (v1.61) and create a new docker tag v1.62 for the new release of castlemock once it's released

Tomcat base image (tomcat:8.5-jre10) is deprecated

The current dockerfile references the tomcat:8.5-jre10 image, which - according to DockerHub - hasn't been updated for a year.

After a short research I've found the following related issue on the tomcat/docker-library project: docker-library/tomcat#175

A possible solution would be to migrate to one of the JDK images available, e. g. 8.5-jdk11-openjdk. All available images can be found on the tomcat DockerHub page: https://hub.docker.com/_/tomcat

Remove ROOT webapp from Tomcat and add redirect to castlemock

Currently the ROOT webapp from Tomcat is included in the installation, causing the default pages from Tomcat to be shown when the container is accessed via an URL that does not contain the castlemock context root (e. g. http://localhost:8080/).

For convenience reasons the default ROOT webapp should be removed and replaced with a redirect to the castlemock webroot.

Modify admin password in docker image

Is it possible to modify the default password in the docker image?

Docker-compose auto import projects

Hi,

I have configuration in docker-compose:

    mockserver_aggregator:
        image: castlemock/castlemock
        ports:
            - 8080:8080
        volumes:
            - ./_infrastructure/mockserver/.castlemock:/root/.castlemock

How i can auto import some projects when service start in docker-compose?

Add support for importing project files

It would be handy if there was a simple way of including castlemock project files into docker image so those projects would be included when image is started. Perhaps additional argument to docker run... command could be path(s) to those project files.

Using https instead of http

Thanks for the great project, I have just starting looking into and it looks promising for my needs.

A question, what would be involved in running the docker image using https instead of the default port 8080, my production environment which is not docker forces use of https and I dont want to have to modify my client code to be able to use castlemock for development purposes.

Thanks again for the work put into this project