🥇 शून्य डाउनटाइम उपयोजन आणि डेटाबेस

हा लेख उपयोजनामध्ये डेटाबेस सुसंगतता समस्यांचे निराकरण कसे करावे याबद्दल तपशीलवार वर्णन करतो. जर तुम्ही प्राथमिक तयारी न करता उपयोजित करण्याचा प्रयत्न केला तर तुमच्या उत्पादन अनुप्रयोगांचे काय होऊ शकते ते आम्ही तुम्हाला सांगू. त्यानंतर आम्ही शून्य डाउनटाइम (अंदाजे लेन: पुढे - शून्य डाउनटाइम). आमच्या ऑपरेशन्सचा परिणाम म्हणजे बॅकवर्ड-विसंगत डेटाबेस बदल बॅकवर्ड-सुसंगत पद्धतीने लागू करणे.

तुम्हाला लेखातील कोड उदाहरणे समजून घ्यायची असल्यास, तुम्ही ती येथे शोधू शकता GitHub.

परिचय

शून्य डाउनटाइम उपयोजन

काय गूढ शून्य डाउनटाइम उपयोजन? तुम्ही असे म्हणू शकता जेव्हा तुमचा ॲप्लिकेशन अशा प्रकारे उपयोजित केला जातो की तुम्ही ॲप्लिकेशनची नवीन आवृत्ती उत्पादनात यशस्वीपणे सादर करू शकता, तर वापरकर्त्याला त्याची अनुपलब्धता लक्षात येत नाही. वापरकर्ता आणि कंपनीच्या दृष्टीकोनातून, हे सर्वोत्कृष्ट उपयोजन परिस्थिती आहे कारण ते नवीन वैशिष्ट्ये सादर करण्यास आणि व्यत्ययाशिवाय दोष निराकरण करण्यास अनुमती देते.

हे कसे साध्य करायचे? अनेक मार्ग आहेत, त्यापैकी एक येथे आहे:

तुमच्या सेवेची आवृत्ती क्रमांक 1 तैनात करा
डेटाबेस स्थलांतर करा
आवृत्ती #2 च्या समांतर आपल्या सेवेची आवृत्ती #1 तैनात करा
ती आवृत्ती क्रमांक 2 जशी पाहिजे तशी कार्य करते हे पाहताच, आवृत्ती क्रमांक 1 काढून टाका
तयार आहे

सोपे, नाही का? दुर्दैवाने, हे इतके सोपे नाही आणि आम्ही ते नंतर तपशीलवार पाहू. आता आणखी एक सामान्य उपयोजन प्रक्रिया तपासू - निळा हिरवा उपयोजन.

तुम्ही कधी ऐकले आहे का? निळा हिरवा उपयोजन? क्लाउड फाउंड्री हे अत्यंत सोपे करते. जरा बघा हा लेख, जिथे आम्ही याचे अधिक तपशीलवार वर्णन करतो. थोडक्यात सारांश देण्यासाठी, आम्ही तुम्हाला निळा हिरवा उपयोजन कसा करावा याची आठवण करून देऊ:

तुमच्या उत्पादन कोडच्या दोन प्रती (“निळा” आणि “हिरवा”) काम करत असल्याची खात्री करा;
सर्व रहदारी निळ्या वातावरणाकडे निर्देशित करा, उदा. जेणेकरून उत्पादन URL तेथे निर्देशित करतात;
हिरव्या वातावरणात अनुप्रयोगातील सर्व बदल तैनात आणि चाचणी करा;
निळ्या ते हिरव्या वातावरणात URL स्विच करा

ब्लू ग्रीन डिप्लॉयमेंट हा एक दृष्टीकोन आहे जो तुम्हाला प्रोडक्शन ब्रेकिंगची चिंता न करता सहजपणे नवीन वैशिष्ट्ये सादर करण्यास अनुमती देतो. हे या वस्तुस्थितीमुळे आहे की जरी काही घडले तरीही, तुम्ही "स्विच फ्लिक" करून सहजपणे मागील वातावरणात परत येऊ शकता.

वरील सर्व वाचल्यानंतर, तुम्ही प्रश्न विचारू शकता: शून्य डाउनटाइमचा ब्लू ग्रीन डिप्लॉयमेंटशी काय संबंध आहे?

बरं, त्यांच्यात बरेच साम्य आहे, कारण एकाच वातावरणाच्या दोन प्रती टिकवून ठेवण्यासाठी त्यांना दुप्पट प्रयत्न करावे लागतील. त्यामुळे काही संघांचा दावा आहे मार्टिन फॉलर, या दृष्टिकोनाच्या भिन्नतेचे अनुसरण करा:

दुसरा पर्याय म्हणजे समान डेटाबेस वापरणे, वेब आणि डोमेन स्तरांसाठी निळे-हिरवे स्विच तयार करणे. या दृष्टिकोनामध्ये, डेटाबेसमध्ये अनेकदा समस्या असू शकतात, विशेषत: जेव्हा तुम्हाला सॉफ्टवेअरच्या नवीन आवृत्तीचे समर्थन करण्यासाठी त्याची स्कीमा बदलण्याची आवश्यकता असते.

आणि येथे आम्ही या लेखातील मुख्य समस्येकडे आलो आहोत. डेटाबेस. या वाक्यांशाकडे आणखी एक नजर टाकूया.

डेटाबेस स्थलांतर करा.

आता तुम्हाला स्वतःला प्रश्न विचारावा लागेल - जर डेटाबेस बदल बॅकवर्ड सुसंगत नसेल तर? अॅपची माझी पहिली आवृत्ती खंडित होणार नाही? खरे तर हेच घडणार आहे...

त्यामुळे, शून्य डाउनटाइम / ब्लू ग्रीन डिप्लॉयमेंटचे प्रचंड फायदे असूनही, कंपन्या त्यांचे अर्ज तैनात करण्यासाठी खालील सुरक्षित प्रक्रियेचे पालन करतात:

अनुप्रयोगाच्या नवीन आवृत्तीसह पॅकेज तयार करा
चालू असलेला अनुप्रयोग बंद करा
डेटाबेस स्थलांतरित करण्यासाठी स्क्रिप्ट चालवा
उपयोजित करा आणि अनुप्रयोगाची नवीन आवृत्ती लाँच करा

या लेखात, शून्य डाउनटाइम उपयोजनाचा लाभ घेण्यासाठी तुम्ही तुमच्या डेटाबेस आणि कोडसह कसे कार्य करू शकता ते आम्ही तपशीलवार सांगू.

डेटाबेस समस्या

जर तुमच्याकडे स्टेटलेस ऍप्लिकेशन असेल जे डेटाबेसमध्ये कोणताही डेटा संचयित करत नसेल, तर तुम्ही लगेच शून्य डाउनटाइम उपयोजन मिळवू शकता. दुर्दैवाने, बर्‍याच सॉफ्टवेअरला कुठेतरी डेटा संग्रहित करणे आवश्यक आहे. म्हणूनच सर्किटमध्ये कोणतेही बदल करण्यापूर्वी तुम्ही दोनदा विचार केला पाहिजे. स्कीमा कसा बदलायचा याच्या तपशिलात जाण्यापूर्वी, जेणेकरुन नो-डाउनटाइम डिप्लॉयमेंट शक्य होईल, प्रथम व्हर्जनिंग स्कीमावर लक्ष केंद्रित करूया.

आवृत्ती योजना

या लेखात आपण वापरणार आहोत फ्लायवे आवृत्ती नियंत्रण साधन म्हणून (अंदाजे भाषांतर: आम्ही डेटाबेस स्थलांतराबद्दल बोलत आहोत). साहजिकच, आम्ही एक स्प्रिंग बूट अॅप्लिकेशन देखील लिहू ज्यामध्ये फ्लायवे सपोर्ट आहे आणि अॅप्लिकेशन संदर्भ सेट करताना स्कीमा माइग्रेशन करेल. फ्लायवे वापरताना, तुम्ही तुमच्या प्रोजेक्ट फोल्डरमध्ये स्थलांतरण स्क्रिप्ट संचयित करू शकता (डीफॉल्टनुसार classpath:db/migration). येथे तुम्ही अशा माइग्रेशन फाइल्सचे उदाहरण पाहू शकता

└── db
 └── migration
     ├── V1__init.sql
     ├── V2__Add_surname.sql
     ├── V3__Final_migration.sql
     └── V4__Remove_lastname.sql

या उदाहरणात आपण 4 मायग्रेशन स्क्रिप्ट पाहतो ज्या, जर पूर्वी कार्यान्वित केल्या नसतील तर, अनुप्रयोग सुरू झाल्यावर एकामागून एक कार्यान्वित केल्या जातील. चला फाईल्सपैकी एक पाहूया (V1__init.sql) उदाहरणार्थ.

CREATE TABLE PERSON (
id BIGINT GENERATED BY DEFAULT AS IDENTITY,
first_name varchar(255) not null,
last_name varchar(255) not null
);

insert into PERSON (first_name, last_name) values ('Dave', 'Syer');

सर्व काही पूर्णपणे स्वयं-स्पष्टीकरणात्मक आहे: तुमचा डेटाबेस कसा सुधारला जावा हे परिभाषित करण्यासाठी तुम्ही SQL वापरू शकता. स्प्रिंग बूट आणि फ्लायवेबद्दल अधिक माहितीसाठी, तपासा स्प्रिंग बूट डॉक्स.

स्प्रिंग बूटसह स्त्रोत नियंत्रण साधन वापरून, तुम्हाला 2 मोठे फायदे मिळतील:

तुम्ही कोड बदलांपासून डेटाबेस बदल वेगळे करता
डेटाबेस स्थलांतरण तुमच्या अनुप्रयोगाच्या रोलआउटसह होते, उदा. तुमची उपयोजन प्रक्रिया सोपी केली आहे

डेटाबेस समस्यांचे निवारण

लेखाच्या पुढील भागात, आम्ही डेटाबेस बदलांच्या दोन पद्धतींवर लक्ष केंद्रित करू.

मागासलेली विसंगतता
मागास सहत्वता

पहिली एक चेतावणी मानली जाईल की तुम्ही प्राथमिक तयारीशिवाय शून्य डाउनटाइम उपयोजन करू नये... दुसरा एक उपाय ऑफर करतो की तुम्ही डाउनटाइमशिवाय तैनाती कशी करू शकता आणि त्याच वेळी मागास अनुकूलता राखू शकता.

आमचा प्रकल्प ज्यावर आम्ही काम करणार आहोत ते एक साधे स्प्रिंग बूट फ्लायवे अॅप्लिकेशन असेल Person с first_name и last_name डेटाबेसमध्ये (अंदाजे अनुवाद: Person एक टेबल आहे आणि first_name и last_name - ही त्यातील फील्ड आहेत). आम्हाला नाव बदलायचे आहे last_name в surname.

गृहीतके

आम्ही तपशीलांमध्ये जाण्यापूर्वी, आमच्या अर्जांबद्दल आम्हाला काही गृहितकं बांधण्याची आवश्यकता आहे. आम्ही प्राप्त करू इच्छित मुख्य परिणाम एक बर्यापैकी सोपी प्रक्रिया असेल.

चिठ्ठी. व्यवसाय प्रो-टिप. प्रक्रिया सुलभ केल्याने तुमचा सपोर्टवर खूप पैसा वाचू शकतो (तुमच्या कंपनीसाठी तुम्ही जितके जास्त लोक काम करता तितके जास्त पैसे तुम्ही वाचवू शकता)!

डेटाबेस रोलबॅक करण्याची आवश्यकता नाही

हे उपयोजन प्रक्रिया सुलभ करते (काही डेटाबेस रोलबॅक जवळजवळ अशक्य आहेत, जसे की हटवणे रोलबॅक). आम्ही फक्त अनुप्रयोग रोल बॅक करण्यास प्राधान्य देतो. अशा प्रकारे, तुमच्याकडे वेगवेगळे डेटाबेस (उदाहरणार्थ, SQL आणि NoSQL) असले तरीही, तुमची उपयोजन पाइपलाइन सारखीच दिसेल.

अॅप्लिकेशनची एक आवृत्ती परत आणणे नेहमीच शक्य असले पाहिजे (आणखी नाही)

रोलबॅक फक्त आवश्यक तेव्हाच केले पाहिजे. सध्याच्या आवृत्तीमध्ये एखादा बग असल्यास जो सहज निराकरण होत नाही, तर आम्ही नवीनतम कार्यरत आवृत्तीवर परत येऊ शकतो. आम्ही असे गृहीत धरतो की ही नवीनतम कार्यरत आवृत्ती मागील आवृत्ती आहे. एकापेक्षा जास्त रोलआउटसाठी कोड आणि डेटाबेस सुसंगतता राखणे अत्यंत कठीण आणि महाग असेल.

चिठ्ठी. अधिक वाचनीयतेसाठी, या लेखात आम्ही अनुप्रयोगाची मुख्य आवृत्ती बदलू.

पायरी 1: प्रारंभिक स्थिती

अ‍ॅप आवृत्ती: 1.0.0
DB आवृत्ती: v1

एक टिप्पणी

ही अर्जाची प्रारंभिक स्थिती असेल.

डेटाबेस बदलतो

DB समाविष्ट आहे last_name.

CREATE TABLE PERSON (
id BIGINT GENERATED BY DEFAULT AS IDENTITY,
first_name varchar(255) not null,
last_name varchar(255) not null
);

insert into PERSON (first_name, last_name) values ('Dave', 'Syer');

कोड बदलतो

अॅप्लिकेशन व्यक्तीचा डेटा यामध्ये साठवतो last_name:

/*
 * Copyright 2012-2016 the original author or authors.
 *
 * 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.
 */

package sample.flyway;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;

@Entity
public class Person {
    @Id
    @GeneratedValue
    private Long id;
    private String firstName;
    private String lastName;

    public String getFirstName() {
        return this.firstName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }

    public String getLastName() {
        return this.lastName;
    }

    public void setLastName(String lastname) {
        this.lastName = lastname;
    }

    @Override
    public String toString() {
        return "Person [firstName=" + this.firstName + ", lastName=" + this.lastName
                + "]";
    }
}

मागे विसंगत स्तंभ पुनर्नामित करणे

स्तंभाचे नाव कसे बदलायचे याचे उदाहरण पाहू:

लक्ष. खालील उदाहरण जाणूनबुजून गोष्टी खंडित करेल. डेटाबेस सुसंगततेची समस्या दाखवण्यासाठी आम्ही हे दाखवतो.

अ‍ॅप आवृत्ती: 2.0.0.BAD

DB आवृत्ती: v2bad

एक टिप्पणी

सध्याचे बदल आम्हाला एकाच वेळी दोन उदाहरणे (जुने आणि नवीन) चालवण्याची परवानगी देत नाहीत. अशा प्रकारे, शून्य डाउनटाइम उपयोजन साध्य करणे कठीण होईल (जर गृहितके विचारात घेतली गेली तर ते प्रत्यक्षात अशक्य आहे).

A/B चाचणी

सध्याची परिस्थिती अशी आहे की आमच्याकडे अॅप्लिकेशन व्हर्जन आहे 1.0.0, उत्पादन आणि डेटाबेस मध्ये तैनात v1. आम्हाला अनुप्रयोगाचा दुसरा प्रसंग, आवृत्ती तैनात करणे आवश्यक आहे 2.0.0.BAD, आणि डेटाबेस अद्यतनित करा v2bad.

पायऱ्या:

आवृत्ती अनुप्रयोगाचा एक नवीन प्रसंग तैनात केला आहे 2.0.0.BADजे डेटाबेसला अपडेट करते v2bad
डेटाबेस मध्ये v2bad स्तंभ last_name यापुढे अस्तित्वात नाही - ते मध्ये बदलले होते surname
डेटाबेस आणि ऍप्लिकेशन अपडेट यशस्वी झाले आणि काही उदाहरणे चालू आहेत 1.0.0, इतर - मध्ये 2.0.0.BAD. सर्व काही डेटाबेसशी जोडलेले आहे v2bad
आवृत्तीची सर्व उदाहरणे 1.0.0 एरर फेकणे सुरू करेल कारण ते कॉलममध्ये डेटा घालण्याचा प्रयत्न करतील last_nameजो यापुढे अस्तित्वात नाही
आवृत्तीची सर्व उदाहरणे 2.0.0.BAD समस्यांशिवाय कार्य करेल

तुम्ही बघू शकता, जर आम्ही डेटाबेस आणि ऍप्लिकेशनमध्ये मागे विसंगत बदल केले, तर A/B चाचणी अशक्य आहे.

अर्ज रोलबॅक

समजू की A/B उपयोजन करण्याचा प्रयत्न केल्यानंतर (अंदाजे प्रति.: लेखकाचा अर्थ कदाचित येथे A/B चाचणी असावा) आम्‍ही ठरवले की आम्‍हाला अॅप्लिकेशनला आवृत्तीवर परत आणायचे आहे 1.0.0. समजा आम्ही डेटाबेस रोलबॅक करू इच्छित नाही.

पायऱ्या:

आम्ही आवृत्ती अनुप्रयोग उदाहरण थांबवतो 2.0.0.BAD
डेटाबेस अजूनही आहे v2bad
आवृत्ती पासून 1.0.0 ते काय आहे ते समजत नाही surname, आम्ही त्रुटी पाहू
नरक तुटला आहे, आम्ही आता परत जाऊ शकत नाही

तुम्ही बघू शकता, आम्ही डेटाबेस आणि ऍप्लिकेशनमध्ये मागे विसंगत बदल केल्यास, आम्ही मागील आवृत्तीवर परत येऊ शकत नाही.

स्क्रिप्ट अंमलबजावणी लॉग

Backward incompatible scenario:

01) Run 1.0.0
02) Wait for the app (1.0.0) to boot
03) Generate a person by calling POST localhost:9991/person to version 1.0.0
04) Run 2.0.0.BAD
05) Wait for the app (2.0.0.BAD) to boot
06) Generate a person by calling POST localhost:9991/person to version 1.0.0 <-- this should fail
07) Generate a person by calling POST localhost:9992/person to version 2.0.0.BAD <-- this should pass

Starting app in version 1.0.0
Generate a person in version 1.0.0
Sending a post to 127.0.0.1:9991/person. This is the response:

{"firstName":"b73f639f-e176-4463-bf26-1135aace2f57","lastName":"b73f639f-e176-4463-bf26-1135aace2f57"}

Starting app in version 2.0.0.BAD
Generate a person in version 1.0.0
Sending a post to 127.0.0.1:9991/person. This is the response:

curl: (22) The requested URL returned error: 500 Internal Server Error

Generate a person in version 2.0.0.BAD
Sending a post to 127.0.0.1:9995/person. This is the response:

{"firstName":"e156be2e-06b6-4730-9c43-6e14cfcda125","surname":"e156be2e-06b6-4730-9c43-6e14cfcda125"}

डेटाबेस बदलतो

नाव बदलणारी स्थलांतर स्क्रिप्ट last_name в surname

स्रोत फ्लायवे स्क्रिप्ट:

CREATE TABLE PERSON (
id BIGINT GENERATED BY DEFAULT AS IDENTITY,
first_name varchar(255) not null,
last_name varchar(255) not null
);

insert into PERSON (first_name, last_name) values ('Dave', 'Syer');

नाव बदलणारी स्क्रिप्ट last_name.

-- This change is backward incompatible - you can't do A/B testing
ALTER TABLE PERSON CHANGE last_name surname VARCHAR;

कोड बदलतो

आम्ही क्षेत्राचे नाव बदलले आहे lastName वर surname.

बॅकवर्ड-सुसंगत पद्धतीने स्तंभाचे नाव बदलणे

ही सर्वात सामान्य परिस्थिती आहे जी आपल्याला येऊ शकते. आपण मागे विसंगत बदल करणे आवश्यक आहे. आम्ही आधीच सिद्ध केले आहे की शून्य-डाउनटाइम उपयोजनासाठी, आम्ही अतिरिक्त चरणांशिवाय डेटाबेस स्थलांतर लागू करू नये. लेखाच्या या विभागात, आम्ही बॅकवर्ड सुसंगतता राखून इच्छित परिणाम साध्य करण्यासाठी डेटाबेस स्थलांतरासह अनुप्रयोगाचे 3 उपयोजन करू.

चिठ्ठी. आमच्याकडे आवृत्ती डेटाबेस आहे हे लक्षात ठेवा v1. त्यात स्तंभ आहेत first_name и last_name. आपल्याला बदलावे लागेल last_name वर surname. आमच्याकडे अॅप आवृत्ती देखील आहे 1.0.0, जे अद्याप वापरलेले नाही surname.

पायरी 2: आडनाव जोडा

अ‍ॅप आवृत्ती: 2.0.0
DB आवृत्ती: v2

एक टिप्पणी

नवीन स्तंभ जोडून आणि त्यातील सामग्री कॉपी करून, आम्ही बॅकवर्ड सुसंगत डेटाबेस बदल तयार करतो. त्याच वेळी, आम्ही JAR रोलबॅक केल्यास किंवा जुने JAR चालू असल्यास, ते कार्यान्वित करताना खंडित होणार नाही.

आम्ही एक नवीन आवृत्ती आणत आहोत

पायऱ्या:

नवीन स्तंभ तयार करण्यासाठी डेटाबेस स्थलांतर करा surname. आता तुमची डीबी आवृत्ती v2
पासून डेटा कॉपी करा last_name в surname. लक्ष द्याकी तुमच्याकडे भरपूर डेटा असल्यास, तुम्ही बॅच स्थलांतराचा विचार करावा!
ते जिथे वापरले जातात ते कोड लिहा दोन्ही и नवीनआणि जुन्या स्तंभ आता तुमची अॅप आवृत्ती 2.0.0
स्तंभातील मूल्य वाचा surname, ते नसल्यास null, किंवा l पासूनast_name, तर ए surname निर्दिष्ट नाही. तुम्ही हटवू शकता getLastName() कोडमधून, कारण ते आउटपुट करेल null पासून तुमचा अर्ज परत आणताना 3.0.0 ते 2.0.0.

जर तुम्ही स्प्रिंग बूट फ्लायवे वापरत असाल, तर आवृत्ती स्टार्टअप दरम्यान या दोन पायऱ्या केल्या जातील 2.0.0 अनुप्रयोग तुम्ही डेटाबेस व्हर्जनिंग टूल मॅन्युअली चालवल्यास, तुम्हाला हे करण्यासाठी दोन वेगवेगळ्या गोष्टी कराव्या लागतील (प्रथम डीबी व्हर्जन मॅन्युअली अपडेट करा आणि नंतर नवीन अॅप्लिकेशन डिप्लॉय करा).

हे महत्वाचे आहे. नवीन तयार केलेला स्तंभ लक्षात ठेवा नये быть नाही. तुम्ही रोलबॅक केल्यास, जुन्या अॅप्लिकेशनला नवीन कॉलमबद्दल माहिती नसते आणि तो यादरम्यान इन्स्टॉल करणार नाही. Insert. पण जर तुम्ही ही मर्यादा जोडली आणि तुमचा डीबी होईल v2, यासाठी नवीन स्तंभाचे मूल्य सेट करणे आवश्यक आहे. ज्यामुळे निर्बंधांचे उल्लंघन होईल.

हे महत्वाचे आहे. आपण पद्धत काढली पाहिजे getLastName(), कारण आवृत्तीमध्ये 3.0.0 कोडमध्ये स्तंभाची संकल्पना नाही last_name. याचा अर्थ असा की तेथे नल सेट केले जाईल. तुम्ही पद्धत सोडू शकता आणि चेक जोडू शकता null, परंतु तर्कामध्ये याची खात्री करणे हा एक चांगला उपाय आहे getSurname() तुम्ही योग्य शून्य नसलेले मूल्य निवडले आहे.

A/B चाचणी

सध्याची परिस्थिती अशी आहे की आमच्याकडे अॅप्लिकेशन व्हर्जन आहे 1.0.0, उत्पादनावर उपयोजित, आणि डेटाबेसमध्ये v1. आम्हाला आवृत्ती अनुप्रयोगाचा दुसरा प्रसंग उपयोजित करण्याची आवश्यकता आहे 2.0.0जे डेटाबेस अपडेट करेल v2.

पायऱ्या:

आवृत्ती अनुप्रयोगाचा एक नवीन प्रसंग तैनात केला आहे 2.0.0जे डेटाबेसला अपडेट करते v2
यादरम्यान काही विनंत्यांवर आवृत्ती उदाहरणांद्वारे प्रक्रिया केली गेली 1.0.0
अद्यतन यशस्वी झाले आणि तुमच्याकडे आवृत्ती अनुप्रयोगाची एकापेक्षा जास्त उदाहरणे चालू आहेत 1.0.0 आणि इतर आवृत्त्या 2.0.0. मध्ये डेटाबेससह प्रत्येकजण संवाद साधतो v2
आवृत्ती 1.0.0 डेटाबेसमध्ये आडनाव स्तंभ वापरत नाही, परंतु आवृत्ती 2.0.0 वापरते. ते एकमेकांमध्ये व्यत्यय आणत नाहीत आणि कोणतीही त्रुटी नसावी.
आवृत्ती 2.0.0 मागास सुसंगतता सुनिश्चित करून जुन्या आणि नवीन दोन्ही स्तंभांमध्ये डेटा संग्रहित करते

हे महत्वाचे आहे. तुमच्याकडे जुन्या/नवीन स्तंभातील मूल्यांवर आधारित आयटमची गणना करणाऱ्या कोणत्याही क्वेरी असल्यास, तुम्ही लक्षात ठेवावे की तुमच्याकडे आता डुप्लिकेट मूल्ये आहेत (बहुधा ती अजूनही स्थलांतरित आहेत). उदाहरणार्थ, जर तुम्हाला अशा वापरकर्त्यांची संख्या मोजायची असेल ज्यांचे आडनाव (स्तंभ काहीही असो) अक्षराने सुरू झाले. A, नंतर डेटा स्थलांतर पूर्ण होईपर्यंत (old → new कॉलम) तुम्ही नवीन कॉलम क्वेरी केल्यास तुमच्याकडे विसंगत डेटा असू शकतो.

अर्ज रोलबॅक

आता आमच्याकडे अॅप आवृत्ती आहे 2.0.0 आणि डेटाबेस मध्ये v2.

पायऱ्या:

तुमचा अर्ज आवृत्तीवर परत आणा 1.0.0.
आवृत्ती 1.0.0 डेटाबेसमधील स्तंभ वापरत नाही surname, त्यामुळे रोलबॅक यशस्वी झाला पाहिजे

डीबी बदलतो

डेटाबेसमध्ये नावाचा कॉलम आहे last_name.

फ्लायवे स्रोत स्क्रिप्ट:

CREATE TABLE PERSON (
id BIGINT GENERATED BY DEFAULT AS IDENTITY,
first_name varchar(255) not null,
last_name varchar(255) not null
);

insert into PERSON (first_name, last_name) values ('Dave', 'Syer');

स्क्रिप्ट जोडा surname.

लक्ष. लक्षात ठेवा की तुम्ही जोडत असलेल्या स्तंभामध्ये तुम्ही कोणत्याही NOT NULL मर्यादा जोडू शकत नाही. तुम्ही JAR रोलबॅक केल्यास, जुन्या आवृत्तीला जोडलेल्या स्तंभाबद्दल कल्पना नसेल आणि ती स्वयंचलितपणे NULL वर सेट होईल. अशी मर्यादा असल्यास, जुना अनुप्रयोग फक्त खंडित होईल.

-- NOTE: This field can't have the NOT NULL constraint cause if you rollback, the old version won't know about this field
-- and will always set it to NULL
ALTER TABLE PERSON ADD surname varchar(255);

-- WE'RE ASSUMING THAT IT'S A FAST MIGRATION - OTHERWISE WE WOULD HAVE TO MIGRATE IN BATCHES
UPDATE PERSON SET PERSON.surname = PERSON.last_name

कोड बदलतो

आम्ही डेटा म्हणून संग्रहित करतो last_name, आणि मध्ये surname. त्याच वेळी आम्ही पासून वाचले last_name, कारण हा स्तंभ सर्वात संबंधित आहे. उपयोजन प्रक्रियेदरम्यान, काही विनंत्यांवर अद्याप अद्यतनित न केलेल्या अनुप्रयोग उदाहरणाद्वारे प्रक्रिया केली जाऊ शकते.

/*
 * Copyright 2012-2016 the original author or authors.
 *
 * 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.
 */

package sample.flyway;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;

@Entity
public class Person {
    @Id
    @GeneratedValue
    private Long id;
    private String firstName;
    private String lastName;
    private String surname;

    public String getFirstName() {
        return this.firstName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }

    /**
     * Reading from the new column if it's set. If not the from the old one.
     *
     * When migrating from version 1.0.0 -> 2.0.0 this can lead to a possibility that some data in
     * the surname column is not up to date (during the migration process lastName could have been updated).
     * In this case one can run yet another migration script after all applications have been deployed in the
     * new version to ensure that the surname field is updated.
     *
     * However it makes sense since when looking at the migration from 2.0.0 -> 3.0.0. In 3.0.0 we no longer
     * have a notion of lastName at all - so we don't update that column. If we rollback from 3.0.0 -> 2.0.0 if we
     * would be reading from lastName, then we would have very old data (since not a single datum was inserted
     * to lastName in version 3.0.0).
     */
    public String getSurname() {
        return this.surname != null ? this.surname : this.lastName;
    }

    /**
     * Storing both FIRST_NAME and SURNAME entries
     */
    public void setSurname(String surname) {
        this.lastName = surname;
        this.surname = surname;
    }

    @Override
    public String toString() {
        return "Person [firstName=" + this.firstName + ", lastName=" + this.lastName + ", surname=" + this.surname
                + "]";
    }
}

पायरी 3: कोडमधून आडनाव काढून टाकत आहे

अ‍ॅप आवृत्ती: 3.0.0

DB आवृत्ती:v3

एक टिप्पणी

नोंद प्रति.: वरवर पाहता, मूळ लेखात लेखकाने चुकून या ब्लॉकचा मजकूर चरण 2 मधून कॉपी केला आहे. या चरणावर, कॉलम वापरणारी कार्यक्षमता काढून टाकण्याच्या उद्देशाने ऍप्लिकेशन कोडमध्ये बदल केले पाहिजेत. last_name.

नवीन स्तंभ जोडून आणि त्यातील सामग्री कॉपी करून, आम्ही बॅकवर्ड सुसंगत डेटाबेस बदल तयार केले. तसेच, आम्ही JAR रोलबॅक केल्यास किंवा जुने JAR चालू असल्यास, ते कार्यान्वित करताना खंडित होणार नाही.

अर्ज रोलबॅक

सध्या आमच्याकडे अॅप आवृत्ती आहे 3.0.0 आणि डेटाबेस v3. आवृत्ती 3.0.0 मध्ये डेटा जतन करत नाही last_name. याचा अर्थ असा की मध्ये surname सर्वात अद्ययावत माहिती संग्रहित केली जाते.

पायऱ्या:

तुमचा अर्ज आवृत्तीवर परत आणा 2.0.0.
आवृत्ती 2.0.0 वापरते आणि last_name и surname.
आवृत्ती 2.0.0 घेईल surname, ते शून्य नसल्यास, अन्यथा -last_name

डेटाबेस बदलतो

डेटाबेसमध्ये कोणतेही संरचनात्मक बदल नाहीत. जुन्या डेटाचे अंतिम स्थलांतर करण्यासाठी खालील स्क्रिप्ट कार्यान्वित केली जाते:

-- WE'RE ASSUMING THAT IT'S A FAST MIGRATION - OTHERWISE WE WOULD HAVE TO MIGRATE IN BATCHES
-- ALSO WE'RE NOT CHECKING IF WE'RE NOT OVERRIDING EXISTING ENTRIES. WE WOULD HAVE TO COMPARE
-- ENTRY VERSIONS TO ENSURE THAT IF THERE IS ALREADY AN ENTRY WITH A HIGHER VERSION NUMBER
-- WE WILL NOT OVERRIDE IT.
UPDATE PERSON SET PERSON.surname = PERSON.last_name;

-- DROPPING THE NOT NULL CONSTRAINT; OTHERWISE YOU WILL TRY TO INSERT NULL VALUE OF THE LAST_NAME
-- WITH A NOT_NULL CONSTRAINT.
ALTER TABLE PERSON MODIFY COLUMN last_name varchar(255) NULL DEFAULT NULL;

कोड बदलतो

नोंद प्रति.: या ब्लॉकचे वर्णन देखील चुकून लेखकाने चरण 2 वरून कॉपी केले आहे. लेखाच्या तर्कानुसार, या चरणावरील कोडमधील बदल हे स्तंभासह कार्य करणारे घटक काढून टाकण्याच्या उद्देशाने असावेत. last_name.

आम्ही डेटा म्हणून संग्रहित करतो last_name, आणि मध्ये surname. याव्यतिरिक्त, आम्ही स्तंभातून वाचतो last_name, कारण ते सर्वात संबंधित आहे. उपयोजन प्रक्रियेदरम्यान, काही विनंत्यांवर अद्याप अपग्रेड न केलेल्या उदाहरणाद्वारे प्रक्रिया केली जाऊ शकते.

/*
 * Copyright 2012-2016 the original author or authors.
 *
 * 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.
 */

package sample.flyway;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;

@Entity
public class Person {
    @Id
    @GeneratedValue
    private Long id;
    private String firstName;
    private String surname;

    public String getFirstName() {
        return this.firstName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }

    public String getSurname() {
        return this.surname;
    }

    public void setSurname(String lastname) {
        this.surname = lastname;
    }

    @Override
    public String toString() {
        return "Person [firstName=" + this.firstName + ", surname=" + this.surname
                + "]";
    }
}

पायरी 4: डेटाबेसमधून आडनाव काढून टाकणे

अ‍ॅप आवृत्ती: 4.0.0

DB आवृत्ती: v4

एक टिप्पणी

आवृत्ती कोड वस्तुस्थितीमुळे 3.0.0 स्तंभ वापरला नाही last_name, आम्ही परत रोल केल्यास अंमलबजावणी दरम्यान काहीही वाईट होणार नाही 3.0.0 डेटाबेसमधून कॉलम काढून टाकल्यानंतर.

स्क्रिप्ट अंमलबजावणी लॉग

We will do it in the following way:

01) Run 1.0.0
02) Wait for the app (1.0.0) to boot
03) Generate a person by calling POST localhost:9991/person to version 1.0.0
04) Run 2.0.0
05) Wait for the app (2.0.0) to boot
06) Generate a person by calling POST localhost:9991/person to version 1.0.0
07) Generate a person by calling POST localhost:9992/person to version 2.0.0
08) Kill app (1.0.0)
09) Run 3.0.0
10) Wait for the app (3.0.0) to boot
11) Generate a person by calling POST localhost:9992/person to version 2.0.0
12) Generate a person by calling POST localhost:9993/person to version 3.0.0
13) Kill app (3.0.0)
14) Run 4.0.0
15) Wait for the app (4.0.0) to boot
16) Generate a person by calling POST localhost:9993/person to version 3.0.0
17) Generate a person by calling POST localhost:9994/person to version 4.0.0

Starting app in version 1.0.0
Generate a person in version 1.0.0
Sending a post to 127.0.0.1:9991/person. This is the response:

{"firstName":"52b6e125-4a5c-429b-a47a-ef18bbc639d2","lastName":"52b6e125-4a5c-429b-a47a-ef18bbc639d2"}

Starting app in version 2.0.0

Generate a person in version 1.0.0
Sending a post to 127.0.0.1:9991/person. This is the response:

{"firstName":"e41ee756-4fa7-4737-b832-e28827a00deb","lastName":"e41ee756-4fa7-4737-b832-e28827a00deb"}

Generate a person in version 2.0.0
Sending a post to 127.0.0.1:9992/person. This is the response:

{"firstName":"0c1240f5-649a-4bc5-8aa9-cff855f3927f","lastName":"0c1240f5-649a-4bc5-8aa9-cff855f3927f","surname":"0c1240f5-649a-4bc5-8aa9-cff855f3927f"}

Killing app 1.0.0

Starting app in version 3.0.0

Generate a person in version 2.0.0
Sending a post to 127.0.0.1:9992/person. This is the response:
{"firstName":"74d84a9e-5f44-43b8-907c-148c6d26a71b","lastName":"74d84a9e-5f44-43b8-907c-148c6d26a71b","surname":"74d84a9e-5f44-43b8-907c-148c6d26a71b"}

Generate a person in version 3.0.0
Sending a post to 127.0.0.1:9993/person. This is the response:
{"firstName":"c6564dbe-9ab5-40ae-9077-8ae6668d5862","surname":"c6564dbe-9ab5-40ae-9077-8ae6668d5862"}

Killing app 2.0.0

Starting app in version 4.0.0

Generate a person in version 3.0.0
Sending a post to 127.0.0.1:9993/person. This is the response:

{"firstName":"cbe942fc-832e-45e9-a838-0fae25c10a51","surname":"cbe942fc-832e-45e9-a838-0fae25c10a51"}

Generate a person in version 4.0.0
Sending a post to 127.0.0.1:9994/person. This is the response:

{"firstName":"ff6857ce-9c41-413a-863e-358e2719bf88","surname":"ff6857ce-9c41-413a-863e-358e2719bf88"}

डीबी बदलतो

तुलनेने v3 आम्ही फक्त स्तंभ काढतो last_name आणि गहाळ निर्बंध जोडा.

-- REMOVE THE COLUMN
ALTER TABLE PERSON DROP last_name;

-- ADD CONSTRAINTS
UPDATE PERSON SET surname='' WHERE surname IS NULL;
ALTER TABLE PERSON ALTER COLUMN surname VARCHAR NOT NULL;

कोड बदलतो

कोडमध्ये कोणतेही बदल नाहीत.

निष्कर्ष

अनेक बॅकवर्ड-कॉम्पॅटिबल डिप्लॉयमेंट करून आम्ही बॅकवर्ड-विसंगत कॉलम नाव बदल यशस्वीरित्या लागू केला. खाली केलेल्या क्रियांचा सारांश आहे:

अनुप्रयोग आवृत्ती उपयोजन 1.0.0 с v1 डेटाबेस स्कीमा (स्तंभ नाव = last_name)
अनुप्रयोग आवृत्ती उपयोजन 2.0.0, ज्यामध्ये डेटा साठवला जातो last_name и surname. पासून अर्ज वाचतो last_name. डेटाबेस आवृत्तीमध्ये आहे v2सारखे स्तंभ असलेले last_name, आणि surname. surname l ची प्रत आहेast_name. (सूचना: या स्तंभात शून्य नसलेली मर्यादा नसावी)
अनुप्रयोग आवृत्ती उपयोजन 3.0.0, जे फक्त डेटा संचयित करते surname आणि आडनावावरून वाचतो. डेटाबेससाठी, शेवटचे स्थलांतर होत आहे last_name в surname. तसेच एक मर्यादा नाही पासून काढले last_name. डेटाबेस आता आवृत्तीमध्ये आहे v3
अनुप्रयोग आवृत्ती उपयोजन 4.0.0 - कोडमध्ये कोणतेही बदल केलेले नाहीत. डेटाबेस उपयोजन v4, जे काढून टाकते last_name. येथे तुम्ही डेटाबेसमध्ये कोणतीही गहाळ मर्यादा जोडू शकता.

या पद्धतीचा अवलंब करून, तुम्ही डेटाबेस/अनुप्रयोग सुसंगतता न मोडता नेहमी एक आवृत्ती परत आणू शकता.

कोड

या लेखात वापरलेले सर्व कोड येथे उपलब्ध आहेत जिथूब. खाली अतिरिक्त वर्णन आहे.

प्रकल्प

रेपॉजिटरी क्लोन केल्यानंतर, तुम्हाला खालील फोल्डर रचना दिसेल.

├── boot-flyway-v1              - 1.0.0 version of the app with v1 of the schema
├── boot-flyway-v2              - 2.0.0 version of the app with v2 of the schema (backward-compatible - app can be rolled back)
├── boot-flyway-v2-bad          - 2.0.0.BAD version of the app with v2bad of the schema (backward-incompatible - app cannot be rolled back)
├── boot-flyway-v3              - 3.0.0 version of the app with v3 of the schema (app can be rolled back)
└── boot-flyway-v4              - 4.0.0 version of the app with v4 of the schema (app can be rolled back)

स्क्रिप्ट

तुम्ही खाली दिलेल्या स्क्रिप्टमध्ये वर्णन केलेल्या स्क्रिप्ट चालवू शकता, जे डेटाबेसमध्ये बॅकवर्ड-सुसंगत आणि विसंगत बदल दर्शवेल.

पाहण्यासाठी बॅकवर्ड सुसंगत बदलांसह केस, चालवा:

./scripts/scenario_backward_compatible.sh

आणि पाहण्यासाठी मागे विसंगत बदलांसह केस, चालवा:

./scripts/scenario_backward_incompatible.sh

स्प्रिंग बूट नमुना फ्लायवे

सर्व उदाहरणे वरून घेतली आहेत Spring Boot Sample Flyway.

आपण एक कटाक्ष टाकू शकता http://localhost:8080/flyway, स्क्रिप्टची यादी आहे.

या उदाहरणामध्ये H2 कन्सोल देखील समाविष्ट आहे (at http://localhost:8080/h2-console) त्यामुळे तुम्ही डेटाबेस स्थिती पाहू शकता (डीफॉल्ट jdbc URL आहे jdbc:h2:mem:testdb).

याव्यतिरिक्त

आमच्या ब्लॉगवरील इतर लेख देखील वाचा:

स्त्रोत: www.habr.com

शून्य डाउनटाइम उपयोजन आणि डेटाबेस

परिचय

शून्य डाउनटाइम उपयोजन

डेटाबेस समस्या

आवृत्ती योजना

डेटाबेस समस्यांचे निवारण

गृहीतके

डेटाबेस रोलबॅक करण्याची आवश्यकता नाही

पायरी 1: प्रारंभिक स्थिती

एक टिप्पणी

डेटाबेस बदलतो

कोड बदलतो

मागे विसंगत स्तंभ पुनर्नामित करणे

एक टिप्पणी

A/B चाचणी

अर्ज रोलबॅक

स्क्रिप्ट अंमलबजावणी लॉग

डेटाबेस बदलतो

कोड बदलतो

बॅकवर्ड-सुसंगत पद्धतीने स्तंभाचे नाव बदलणे

पायरी 2: आडनाव जोडा

एक टिप्पणी

आम्ही एक नवीन आवृत्ती आणत आहोत

A/B चाचणी

अर्ज रोलबॅक

डीबी बदलतो

कोड बदलतो

पायरी 3: कोडमधून आडनाव काढून टाकत आहे

एक टिप्पणी

अर्ज रोलबॅक

डेटाबेस बदलतो

कोड बदलतो

पायरी 4: डेटाबेसमधून आडनाव काढून टाकणे

एक टिप्पणी

स्क्रिप्ट अंमलबजावणी लॉग

डीबी बदलतो

कोड बदलतो

निष्कर्ष

कोड

प्रकल्प

स्क्रिप्ट

स्प्रिंग बूट नमुना फ्लायवे

याव्यतिरिक्त

आमच्या ब्लॉगवरील इतर लेख देखील वाचा:

एक टिप्पणी जोडा Отменить ответ