{"id":23318229,"url":"https://github.com/softwareag/sagdevops-ci-assets","last_synced_at":"2025-04-07T04:54:02.714Z","repository":{"id":48376644,"uuid":"86571924","full_name":"SoftwareAG/sagdevops-ci-assets","owner":"SoftwareAG","description":"Software AG DevOps library to support assets CI (continuous integration) with webMethods 9.x and 10.0. Work together with https://github.com/SoftwareAG/webmethods-sample-project-layout","archived":false,"fork":false,"pushed_at":"2022-01-19T15:16:42.000Z","size":8474,"stargazers_count":26,"open_issues_count":6,"forks_count":164,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-02-13T09:30:06.922Z","etag":null,"topics":["ant","automated-deployment","automated-tests","continuous-integration","devops","esb","integration-server","webmethods"],"latest_commit_sha":null,"homepage":"","language":"XSLT","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SoftwareAG.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-03-29T11:01:34.000Z","updated_at":"2023-10-01T06:49:53.000Z","dependencies_parsed_at":"2022-08-24T14:49:52.577Z","dependency_job_id":null,"html_url":"https://github.com/SoftwareAG/sagdevops-ci-assets","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAG%2Fsagdevops-ci-assets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAG%2Fsagdevops-ci-assets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAG%2Fsagdevops-ci-assets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAG%2Fsagdevops-ci-assets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SoftwareAG","download_url":"https://codeload.github.com/SoftwareAG/sagdevops-ci-assets/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247595370,"owners_count":20963943,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ant","automated-deployment","automated-tests","continuous-integration","devops","esb","integration-server","webmethods"],"created_at":"2024-12-20T17:15:59.934Z","updated_at":"2025-04-07T04:54:02.689Z","avatar_url":"https://github.com/SoftwareAG.png","language":"XSLT","readme":"# sagdevops-ci-assets\nSoftware AG DevOps library to support assets CI (continuous integration) with webMethods 9.x and 10.0. Works together with [webMethods sample project layout](https://github.com/SoftwareAG/webmethods-sample-project-layout)\n\n\n## Description\nsagdevops-ci-assets is a library that easily enables CI for your webMethods projects. You can setup your infrastructure in minutes and then deploy flowlessly on your test service while also checking the quality\nby running all tests uploaded your version control.\n\n\n## Set-up\n\n### webMethods Installation\nPrepare your webMethods installation - your build server can contain only a plain IntegrationServer with Deployer. Keep the server plain - there is no need for designer or database connection.\nYour test server can be more complex as CI will execute unit and integration tests against it. The build and the test server must reach each other over http so that the deployment and the testing can be performed.\n\n### CI Library\nDownload the library on your build server by\n\n```\ngit clone https://github.com/SoftwareAG/sagdevops-ci-assets.git\n```\n\nEdit the _System.properties_ to correspond to your inftrastucture - deployerHost is the machine where your Deployer is running(normally the build server) where targetHost is your test server - where the packages will be deployed and tested. \n\n*Notice* change the path the Deployer if you're not using the _default_ Integration Server instance.\n\n\n### Build/CI Environment \n* On your build server set-up the default java on PATH to be the JDK that comes with your webMethods installation ${SAG_HOME}/jvm/jvm/bin/java\n\n* On your build server install Jenkins CI Server and run it with the same user that run your webMethods processes. The CI can work also with other CI server, but for the reference implementation  we've chosen Jenkins.\n\n* In Jenkins-\u003eManage Jenkins-\u003eConfigure System-\u003eEnvironmentVariables define the following environment variables:\n1. SAG_CI_HOME = path_to_th_sagdevops-ci-assets on the local file system.\n2. SAG_HOME = path_to_your_local_webmethods_installation\n\nUse slash \"/\" as path separator. Example: \"C:/SoftwareAG\", instead of \"C:\\SoftwareAG\".\n\n\n\n### Jenkins Pipeline Job\nIn Jenkins, create a new item from type pipeline. Give it a **unique name** as we use the job name as identifier further down the process. Scroll down the page to the pipeline definition\nand choose _Pipeline definition from SCM_. Choose git as system and give the url of the webmethods-sample-project-layout - _https://github.com/SoftwareAG/webmethods-sample-project-layout.git_\n\nThis sample project contains two pre-created pipeline definitions - Jenkinsfile.win and Jenkinsfile.unix that run on the respective operating systems. Type in the correct file in respect of you \nbuild server OS.\n\nThose pipeline definition are orchestrating all steps around the build, deploy and the test on your server. If the all environment variables are set correctly you should not change anything here.\n\n\n## How it works\nAfter your pipeline job is set-up, trigger it. It will download the pipeline description automatically, then checkout the sources, build the core, deploy the code and run tests. \nWhenever a developer checks in new IS packages and Tests those will be automatically deployed and all new tests will be executed. For this to work, the structure defined here  _https://github.com/SoftwareAG/webmethods-sample-project-layout.git_ has followed.\n\n## Notice\nThe wM Test Suite tests will have to be places in a directory a *setup* directory inside the test project, so that it can be picked up by the test executor.\n\n\n# Authors\n[Henning Waack](mailto:Henning.Waack@softwareag.com)  \n[Angel Tcholtchev](mailto:Angel.tcholtchev@softwareag.com)\n\n______________________\nThese tools are provided as-is and without warranty or support. They do not constitute part of the Software AG product suite. Users are free to use, fork and modify them, subject to the license agreement. While Software AG welcomes contributions, we cannot guarantee to include every contribution in the master project.\n_____________\nFor more information you can Ask a Question in the [TECHcommunity Forums](https://tech.forums.softwareag.com/tags/c/forum/1/webMethods).\n\nYou can find additional information in the [Software AG TECHcommunity](https://tech.forums.softwareag.com/tag/webmethods).\n_____________\nContact us at [TECHcommunity](mailto:technologycommunity@softwareag.com?subject=Github/SoftwareAG) if you have any questions.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoftwareag%2Fsagdevops-ci-assets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoftwareag%2Fsagdevops-ci-assets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoftwareag%2Fsagdevops-ci-assets/lists"}