{"id":19243480,"url":"https://github.com/bootique/bootique-flyway","last_synced_at":"2025-04-21T09:33:10.296Z","repository":{"id":45116499,"uuid":"75735154","full_name":"bootique/bootique-flyway","owner":"bootique","description":"Bootique integration with Flyway","archived":false,"fork":false,"pushed_at":"2025-04-19T13:26:57.000Z","size":165,"stargazers_count":5,"open_issues_count":2,"forks_count":3,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-19T18:03:31.634Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://bootique.io","language":"Java","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/bootique.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-12-06T13:43:51.000Z","updated_at":"2025-04-19T13:27:01.000Z","dependencies_parsed_at":"2023-12-05T01:25:04.627Z","dependency_job_id":"4864922d-531b-4f9c-aaaa-1f49bbfc0991","html_url":"https://github.com/bootique/bootique-flyway","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bootique%2Fbootique-flyway","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bootique%2Fbootique-flyway/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bootique%2Fbootique-flyway/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bootique%2Fbootique-flyway/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bootique","download_url":"https://codeload.github.com/bootique/bootique-flyway/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250032345,"owners_count":21363822,"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":[],"created_at":"2024-11-09T17:18:10.670Z","updated_at":"2025-04-21T09:33:05.283Z","avatar_url":"https://github.com/bootique.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n  Licensed to ObjectStyle LLC under one\n  or more contributor license agreements.  See the NOTICE file\n  distributed with this work for additional information\n  regarding copyright ownership.  The ObjectStyle LLC licenses\n  this file to you under the Apache License, Version 2.0 (the\n  \"License\"); you may not use this file except in compliance\n  with the License.  You may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\n  Unless required by applicable law or agreed to in writing,\n  software distributed under the License is distributed on an\n  \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n  KIND, either express or implied.  See the License for the\n  specific language governing permissions and limitations\n  under the License.\n  --\u003e\n\n[![build test deploy](https://github.com/bootique/bootique-flyway/actions/workflows/maven.yml/badge.svg)](https://github.com/bootique/bootique-flyway/actions/workflows/maven.yml)\n[![Maven Central](https://img.shields.io/maven-central/v/io.bootique.flyway/bootique-flyway.svg?colorB=brightgreen)](https://search.maven.org/artifact/io.bootique.flyway/bootique-flyway/)\n\n# bootique-flyway\n\nProvides [Flyway](https://flywaydb.org/) migrations framework integration with [Bootique](http://bootique.io).\nSee usage example [bootique-flyway-demo](https://github.com/bootique-examples/bootique-flyway-demo).\n\n# Setup\n\n## Add bootique-flyway to your build tool:\n\n**Maven**\n```xml\n\u003cdependencyManagement\u003e\n    \u003cdependencies\u003e\n        \u003cdependency\u003e\n            \u003cgroupId\u003eio.bootique.bom\u003c/groupId\u003e\n            \u003cartifactId\u003ebootique-bom\u003c/artifactId\u003e\n            \u003cversion\u003e3.0-M4\u003c/version\u003e\n            \u003ctype\u003epom\u003c/type\u003e\n            \u003cscope\u003eimport\u003c/scope\u003e\n        \u003c/dependency\u003e\n    \u003c/dependencies\u003e\n\u003c/dependencyManagement\u003e\n\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.bootique.flyway\u003c/groupId\u003e\n    \u003cartifactId\u003ebootique-flyway\u003c/artifactId\u003e\n\u003c/dependency\u003e\n```\n\n**Gradle**\n```groovy\ncompile(\"io.bootique.flyway:bootique-flyway:1.0\")\n```\n\n*Note:* **bootique-flyway** is a part of [bootique-bom](https://github.com/bootique/bootique-bom), and version can be \nimported from there.\n\n\n## Available commands\n\n### FLYWAY COMMANDS AS OPTIONS\n\nFlyway is based around just 6 commands: Migrate, Clean, Info, Validate, Baseline and Repair. They are represented in \nthe Bootique-Flyway module as command line options.\n\n```\n  -b, --baseline\n       Baselines an existing database, excluding all migrations up to and including baselineVersion.\n\n  --clean\n       Drops all objects (tables, views, procedures, triggers, ...) in the configured schemas.The schemas are cleaned in the order specified by the schemas property.\n\n  -i, --info\n       Prints the details and status information about all the migrations.\n\n  -m, --migrate\n       Migrates the schema to the latest version. Flyway will create the metadata table automatically if it doesn't exist.\n\n  -r, --repair\n       Repairs the metadata table.\n\n  -v, --validate\n       Validate applied migrations against resolved ones (on the filesystem or classpath) to detect accidental changes that may prevent the schema(s) from being recreated exactly.\n```\n\n### BOOTIQUE OPTIONS\n\nThe standard Bootique command line options you may need:\n\n\n```\n  -c yaml_location, --config=yaml_location\n           Specifies YAML config location, which can be a classpath (prefixed by classpath:), file path or a URL.\n\n  -H, --help-config\n           Prints information about application modules and their configuration\n           options.\n```\n\n## Configuration\n\n### YAML configuration file\n\nAs an example here a YAML test config file: classpath:io/bootique/flyway/explicitNonDefaultMigrationConfigfile.yml.\n\n\n```\njdbc:\n  test:\n    url: jdbc:h2:mem:defaultMigration\n    username: bogus\n    password: bogus\n    driverClassName: org.h2.Driver\n\nflyway:\n  locations:\n    - bogus\n  configFiles:\n    - classpath:io/bootique/flyway/explicitNonDefaultMigrationConfigfile.conf\n  dataSources:\n    - test\n```\n\nOnly three flyway options are recognized:\n- locations: a list of Flyway locations to look for Flyway migrations\n- configFiles: a list of Flyway configuraton files (as custom config files, see https://flywaydb.org/documentation/commandline/)\n- dataSources: a list of JDBC connections\n\nUsing custom config files allows you to more easily run Flyway using a file\nfor database connection settings (the Bootique YAML file) and application\nsettings in a Flyway file.\n\nIn this example the locations property (with bogus as a non-existent location)\nis superseded by the settings in the Flyway configuration file.\n\n### Flyway configuration file\n\nAs an example here a Flyway test configuration file: classpath:io/bootique/flyway/explicitNonDefaultMigrationConfigfile.conf.\n\n\n```\nflyway.locations = path/migration\n```\n\n## Example Project\n\n[bootique-flyway-demo](https://github.com/bootique-examples/bootique-flyway-demo)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbootique%2Fbootique-flyway","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbootique%2Fbootique-flyway","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbootique%2Fbootique-flyway/lists"}