জিরো ডাউনটাইম স্থাপনা এবং ডেটাবেস

এই নিবন্ধটি বিস্তারিতভাবে ব্যাখ্যা করে যে কিভাবে স্থাপনায় ডাটাবেস সামঞ্জস্যের সমস্যাগুলি সমাধান করা যায়। আপনি যদি প্রাথমিক প্রস্তুতি ছাড়াই মোতায়েন করার চেষ্টা করেন তবে আপনার উত্পাদন অ্যাপ্লিকেশনগুলির কী ঘটতে পারে তা আমরা আপনাকে বলব৷ তারপরে আমরা শূন্য ডাউনটাইম (প্রায়. লেন: আরও - শূন্য ডাউনটাইম) আমাদের ক্রিয়াকলাপের ফলাফল হবে পিছনের-অসঙ্গতিপূর্ণ ডাটাবেস পরিবর্তনটি পিছনের-সামঞ্জস্যপূর্ণ পদ্ধতিতে প্রয়োগ করা।

আপনি যদি নিবন্ধ থেকে কোড উদাহরণ বুঝতে চান, আপনি তাদের খুঁজে পেতে পারেন GitHub.

ভূমিকা

শূন্য ডাউনটাইম স্থাপনা

কি একটি রহস্যময় শূন্য ডাউনটাইম স্থাপনা? আপনি এটি বলতে পারেন যখন আপনার অ্যাপ্লিকেশনটি এমনভাবে স্থাপন করা হয় যাতে আপনি সফলভাবে অ্যাপ্লিকেশনটির একটি নতুন সংস্করণ উত্পাদনে প্রবর্তন করতে পারেন, যখন ব্যবহারকারী এটির অনুপলব্ধতা লক্ষ্য করেন না। একটি ব্যবহারকারী এবং কোম্পানির দৃষ্টিকোণ থেকে, এটি সর্বোত্তম সম্ভাব্য স্থাপনার দৃশ্য কারণ এটি নতুন বৈশিষ্ট্যগুলি প্রবর্তন করতে এবং বাগগুলিকে বিঘ্ন ছাড়াই সংশোধন করার অনুমতি দেয়৷

এই অর্জন কিভাবে? বিভিন্ন উপায় আছে, এখানে তাদের মধ্যে একটি:

• আপনার পরিষেবার সংস্করণ নং 1 স্থাপন করুন
• একটি ডাটাবেস মাইগ্রেশন সঞ্চালন
• সংস্করণ #2 এর সমান্তরালে আপনার পরিষেবার সংস্করণ #1 স্থাপন করুন
• যত তাড়াতাড়ি আপনি দেখতে পাবেন যে সংস্করণ নং 2 এটির মতো কাজ করে, সংস্করণ নং 1 সরিয়ে দিন
• সম্পন্ন!

সহজ, তাই না? দুর্ভাগ্যবশত, এটি এত সহজ নয়, এবং আমরা পরে এটি বিস্তারিতভাবে দেখব। এখন আরেকটি মোটামুটি সাধারণ স্থাপনার প্রক্রিয়া পরীক্ষা করা যাক - নীল সবুজ স্থাপনা।

আপনি কি কখনও শুনেছেন? নীল সবুজ স্থাপনা? ক্লাউড ফাউন্ড্রি এটি অত্যন্ত সহজ করে তোলে। শুধু তাকান এই নিবন্ধটি, যেখানে আমরা আরও বিস্তারিতভাবে এটি বর্ণনা করি। সংক্ষেপে সংক্ষিপ্ত করার জন্য, আসুন আমরা আপনাকে মনে করিয়ে দিই কিভাবে নীল সবুজ স্থাপনা করতে হয়:

• নিশ্চিত করুন যে আপনার প্রোডাকশন কোডের দুটি কপি ("নীল" এবং "সবুজ") কাজ করছে;
• নীল পরিবেশে সমস্ত ট্রাফিককে নির্দেশ করুন, যেমন যাতে প্রোডাকশন ইউআরএল সেখানে নির্দেশ করে;
• একটি সবুজ পরিবেশে সমস্ত অ্যাপ্লিকেশন পরিবর্তন স্থাপন এবং পরীক্ষা করুন;
• ইউআরএলকে নীল থেকে সবুজ পরিবেশে স্যুইচ করুন

ব্লু গ্রিন ডিপ্লোয়মেন্ট হল এমন একটি পন্থা যা আপনাকে প্রোডাকশন ব্রেকিং নিয়ে চিন্তা না করে সহজেই নতুন ফিচার প্রবর্তন করতে দেয়। এটি এই কারণে যে কিছু ঘটলেও, আপনি সহজে "একটি সুইচ ফ্লিক করে" পূর্ববর্তী পরিবেশে ফিরে যেতে পারেন।

উপরের সমস্তটি পড়ার পরে, আপনি প্রশ্ন জিজ্ঞাসা করতে পারেন: নীল সবুজ স্থাপনার সাথে শূন্য ডাউনটাইমের কী সম্পর্ক আছে?

ঠিক আছে, তাদের মধ্যে অনেক মিল রয়েছে, যেহেতু একই পরিবেশের দুটি অনুলিপি বজায় রাখতে তাদের বজায় রাখার জন্য দ্বিগুণ প্রচেষ্টা প্রয়োজন। এ কারণে কয়েকটি দল দাবি করেছে মার্টিন ফাওলার, এই পদ্ধতির একটি বৈচিত্র অনুসরণ করুন:

আরেকটি বিকল্প হল একই ডাটাবেস ব্যবহার করা, ওয়েব এবং ডোমেন স্তরগুলির জন্য নীল-সবুজ সুইচ তৈরি করা। এই পদ্ধতিতে, ডাটাবেস প্রায়ই একটি সমস্যা হতে পারে, বিশেষ করে যখন আপনাকে সফ্টওয়্যারের একটি নতুন সংস্করণ সমর্থন করার জন্য এর স্কিমা পরিবর্তন করতে হবে।

এবং এখানে আমরা এই নিবন্ধে প্রধান সমস্যা আসা. ডাটাবেসের. আসুন এই বাক্যাংশটি আরেকবার দেখে নেওয়া যাক।

একটি ডাটাবেস মাইগ্রেশন সঞ্চালন।

এখন আপনি নিজেকে প্রশ্ন জিজ্ঞাসা করতে হবে - যদি ডাটাবেস পরিবর্তন পিছিয়ে সামঞ্জস্যপূর্ণ না হয়? আমার অ্যাপের প্রথম সংস্করণটি ভেঙে যাবে না? আসলে, ঠিক এটাই হবে...

সুতরাং, এমনকি শূন্য ডাউনটাইম / নীল সবুজ স্থাপনার বিশাল সুবিধা থাকা সত্ত্বেও, কোম্পানিগুলি তাদের অ্যাপ্লিকেশন স্থাপনের জন্য নিম্নলিখিত নিরাপদ প্রক্রিয়া অনুসরণ করে:

• অ্যাপ্লিকেশনটির একটি নতুন সংস্করণ সহ একটি প্যাকেজ প্রস্তুত করুন
• একটি চলমান অ্যাপ্লিকেশন বন্ধ করুন
• ডাটাবেস মাইগ্রেট করতে স্ক্রিপ্ট চালান
• অ্যাপ্লিকেশনটির একটি নতুন সংস্করণ স্থাপন এবং চালু করুন

এই নিবন্ধে, আমরা শূন্য ডাউনটাইম স্থাপনার সুবিধা নিতে আপনি কীভাবে আপনার ডাটাবেস এবং কোডের সাথে কাজ করতে পারেন তা বিস্তারিত জানাব।

ডাটাবেস সমস্যা

আপনার যদি একটি স্টেটলেস অ্যাপ্লিকেশন থাকে যা ডাটাবেসে কোনো ডেটা সঞ্চয় করে না, তাহলে আপনি এখনই শূন্য ডাউনটাইম স্থাপনা পেতে পারেন। দুর্ভাগ্যবশত, বেশিরভাগ সফ্টওয়্যারকে কোথাও ডেটা সংরক্ষণ করতে হবে। এই কারণে সার্কিটে কোনো পরিবর্তন করার আগে আপনার দুবার চিন্তা করা উচিত। কীভাবে স্কিমা পরিবর্তন করতে হয় তার বিশদ বিবরণে যাওয়ার আগে যাতে নো-ডাউনটাইম স্থাপনা সম্ভব হয়, আসুন প্রথমে সংস্করণ স্কিমার উপর ফোকাস করি।

সংস্করণ স্কিম

এই নিবন্ধে আমরা ব্যবহার করব ফ্লাইওয়ে একটি সংস্করণ নিয়ন্ত্রণ টুল হিসাবে (প্রায়. অনুবাদ: আমরা ডাটাবেস মাইগ্রেশন সম্পর্কে কথা বলছি) স্বাভাবিকভাবেই, আমরা একটি স্প্রিং বুট অ্যাপ্লিকেশনও লিখব যাতে অন্তর্নির্মিত ফ্লাইওয়ে সমর্থন রয়েছে এবং অ্যাপ্লিকেশন প্রসঙ্গ সেট আপ করার সময় স্কিমা স্থানান্তর সম্পাদন করবে। ফ্লাইওয়ে ব্যবহার করার সময়, আপনি আপনার প্রকল্প ফোল্ডারে মাইগ্রেশন স্ক্রিপ্ট সংরক্ষণ করতে পারেন (ডিফল্টরূপে 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 একটি টেবিল এবং চirst_name и last_name - এই হল এটির ক্ষেত্র) আমরা নাম পরিবর্তন করতে চাই last_name в surname.

অনুমান

আমরা বিস্তারিত জানার আগে, আমাদের অ্যাপ্লিকেশনগুলি সম্পর্কে আমাদের কয়েকটি অনুমান করতে হবে। মূল ফলাফল যা আমরা অর্জন করতে চাই তা হবে একটি মোটামুটি সহজ প্রক্রিয়া।

নোট. বিজনেস প্রো-টিপ। সহজীকরণ প্রক্রিয়াগুলি আপনাকে সমর্থনে প্রচুর অর্থ সাশ্রয় করতে পারে (আপনার কোম্পানির জন্য আপনি যত বেশি লোক কাজ করবেন, আপনি তত বেশি অর্থ সঞ্চয় করতে পারবেন)!

ডাটাবেস রোলব্যাক করার দরকার নেই

এটি স্থাপনা প্রক্রিয়াকে সহজ করে (কিছু ডাটাবেস রোলব্যাক প্রায় অসম্ভব, যেমন মোছা রোলব্যাক)। আমরা শুধুমাত্র অ্যাপ্লিকেশন রোল ব্যাক করতে পছন্দ করি। এইভাবে, এমনকি যদি আপনার বিভিন্ন ডাটাবেস থাকে (উদাহরণস্বরূপ, SQL এবং NoSQL), আপনার স্থাপনার পাইপলাইন একই দেখাবে।

অ্যাপ্লিকেশানটিকে একটি সংস্করণ ফিরিয়ে আনার জন্য সর্বদা সম্ভব হতে হবে (আর কিছু নয়)

রোলব্যাক শুধুমাত্র প্রয়োজন হলেই করা উচিত। যদি বর্তমান সংস্করণে একটি বাগ থাকে যা সহজে ঠিক করা যায় না, তাহলে আমাদের সর্বশেষ কার্যকরী সংস্করণে ফিরে যেতে সক্ষম হওয়া উচিত। আমরা ধরে নিই যে এই সর্বশেষ কার্যকরী সংস্করণটি আগেরটি। একাধিক রোলআউটের জন্য কোড এবং ডাটাবেস সামঞ্জস্য বজায় রাখা অত্যন্ত কঠিন এবং ব্যয়বহুল হবে।

নোট. বৃহত্তর পাঠযোগ্যতার জন্য, এই নিবন্ধে আমরা অ্যাপ্লিকেশনটির প্রধান সংস্করণ পরিবর্তন করব।

ধাপ 1: প্রাথমিক অবস্থা

অ্যাপ্লিকেশন সংস্করণ: 1.0.0
ডিবি সংস্করণ: v1

মন্তব্য

এটি হবে আবেদনের প্রাথমিক অবস্থা।

ডাটাবেস পরিবর্তন

ডিবি ধারণ করে 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

ডিবি সংস্করণ: v2bad

মন্তব্য

বর্তমান পরিবর্তনগুলি আমাদের একই সময়ে দুটি উদাহরণ (পুরানো এবং নতুন) চালানোর অনুমতি দেয় না। সুতরাং, শূন্য ডাউনটাইম স্থাপনা অর্জন করা কঠিন হবে (যদি অনুমানগুলি বিবেচনায় নেওয়া হয় তবে এটি আসলে অসম্ভব)।

A/B পরীক্ষা

বর্তমান পরিস্থিতি আমাদের কাছে একটি অ্যাপ্লিকেশন সংস্করণ রয়েছে 1.0.0, উৎপাদন, এবং ডাটাবেসে স্থাপন করা হয়েছে v1. আমাদের অ্যাপ্লিকেশন, সংস্করণের একটি দ্বিতীয় দৃষ্টান্ত স্থাপন করতে হবে 2.0.0.BAD, এবং ডাটাবেস আপডেট করুন v2bad.

ধাপ:

1. সংস্করণ অ্যাপ্লিকেশনের একটি নতুন উদাহরণ স্থাপন করা হয়েছে 2.0.0.BADযা ডাটাবেস আপডেট করে v2bad
2. ডাটাবেসে v2bad স্তম্ভ last_name আর বিদ্যমান নেই - এটি পরিবর্তিত হয়েছে৷ surname
3. ডাটাবেস এবং অ্যাপ্লিকেশন আপডেট সফল হয়েছে এবং কিছু দৃষ্টান্ত চলছে 1.0.0, অন্যান্য - মধ্যে 2.0.0.BAD. সবকিছু ডাটাবেসের সাথে সংযুক্ত v2bad
4. সংস্করণের সমস্ত উদাহরণ 1.0.0 তারা কলামে তথ্য সন্নিবেশ করার চেষ্টা করবে কারণ ত্রুটি নিক্ষেপ করা শুরু করবে last_nameযারা আর নেই
5. সংস্করণের সমস্ত উদাহরণ 2.0.0.BAD সমস্যা ছাড়াই কাজ করবে

আপনি দেখতে পাচ্ছেন, যদি আমরা ডাটাবেস এবং অ্যাপ্লিকেশনে অসঙ্গতিপূর্ণ পরিবর্তন করি, তাহলে A/B পরীক্ষা করা অসম্ভব।

অ্যাপ্লিকেশন রোলব্যাক

ধরা যাক A/B স্থাপনার চেষ্টা করার পরে (প্রায়. প্রতি.: লেখক সম্ভবত এখানে A/B পরীক্ষা বোঝাতে চেয়েছেন) আমরা সিদ্ধান্ত নিয়েছি যে আমাদের অ্যাপ্লিকেশনটিকে সংস্করণে ফিরিয়ে আনতে হবে 1.0.0. ধরা যাক আমরা ডাটাবেস রোলব্যাক করতে চাই না।

ধাপ:

1. আমরা সংস্করণ অ্যাপ্লিকেশন উদাহরণ বন্ধ 2.0.0.BAD
2. ডাটাবেস এখনও আছে v2bad
3. সংস্করণ থেকে 1.0.0 এটা কি বুঝতে পারে না surname, আমরা ত্রুটি দেখতে পাব
4. জাহান্নাম ভেঙে গেছে, আমরা আর ফিরে যেতে পারি না

আপনি দেখতে পাচ্ছেন, যদি আমরা ডাটাবেস এবং অ্যাপ্লিকেশনে অসঙ্গতিপূর্ণ পরিবর্তন করি, আমরা পূর্ববর্তী সংস্করণে ফিরে যেতে পারি না।

স্ক্রিপ্ট এক্সিকিউশন লগ

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
ডিবি সংস্করণ: v2

মন্তব্য

একটি নতুন কলাম যোগ করে এবং এর বিষয়বস্তু অনুলিপি করে, আমরা পিছনের সামঞ্জস্যপূর্ণ ডাটাবেস পরিবর্তনগুলি তৈরি করি। একই সময়ে, যদি আমরা JAR রোলব্যাক করি বা একটি পুরানো JAR চলমান থাকে তবে এটি কার্যকর করার সময় ভেঙে যাবে না।

আমরা একটি নতুন সংস্করণ রোল আউট করছি

ধাপ:

1. একটি নতুন কলাম তৈরি করতে একটি ডাটাবেস স্থানান্তর করুন surname. এখন আপনার ডিবি সংস্করণ v2
2. থেকে ডেটা অনুলিপি করুন last_name в surname. মনোযোগ দাওযদি আপনার কাছে এই ডেটা অনেক থাকে তবে আপনার ব্যাচ মাইগ্রেশন বিবেচনা করা উচিত!
3. কোড লিখুন যেখানে তারা ব্যবহার করা হয় উভয় и новыйএবং পুরাতন কলাম এখন আপনার অ্যাপ সংস্করণ 2.0.0
4. কলাম থেকে মান পড়ুন 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.

ধাপ:

1. সংস্করণ অ্যাপ্লিকেশনের একটি নতুন উদাহরণ স্থাপন করা হয়েছে 2.0.0যা ডাটাবেস আপডেট করে v2
2. ইতিমধ্যে কিছু অনুরোধ সংস্করণ দৃষ্টান্ত দ্বারা প্রক্রিয়া করা হয়েছে 1.0.0
3. আপডেটটি সফল হয়েছে এবং আপনার কাছে সংস্করণ অ্যাপ্লিকেশনটির একাধিক চলমান উদাহরণ রয়েছে 1.0.0 এবং অন্যান্য সংস্করণ 2.0.0. প্রত্যেকেই ডাটাবেসের সাথে যোগাযোগ করে v2
4. সংস্করণ 1.0.0 ডাটাবেসে উপাধি কলাম ব্যবহার করে না, কিন্তু সংস্করণ 2.0.0 ব্যবহারসমূহ. তারা একে অপরের সাথে হস্তক্ষেপ করে না, এবং কোন ত্রুটি থাকা উচিত নয়।
5. সংস্করণ 2.0.0 পশ্চাদগামী সামঞ্জস্য নিশ্চিত করে পুরানো এবং নতুন উভয় কলামে ডেটা সঞ্চয় করে

এটা গুরুত্বপূর্ণ। আপনার যদি কোনও প্রশ্ন থাকে যা পুরানো/নতুন কলামের মানগুলির উপর ভিত্তি করে আইটেমগুলি গণনা করে, আপনার মনে রাখা উচিত যে আপনার কাছে এখন ডুপ্লিকেট মান রয়েছে (সম্ভবত তারা এখনও স্থানান্তর করছে)। উদাহরণস্বরূপ, আপনি যদি ব্যবহারকারীর সংখ্যা গণনা করতে চান যাদের শেষ নাম (কলামটি যাই বলা হোক না কেন) অক্ষর দিয়ে শুরু হয়েছে A, তারপর ডেটা মাইগ্রেশন সম্পূর্ণ না হওয়া পর্যন্ত (old → new কলাম) যদি আপনি একটি নতুন কলাম অনুসন্ধান করেন তবে আপনার কাছে অসঙ্গত ডেটা থাকতে পারে।

অ্যাপ্লিকেশন রোলব্যাক

এখন আমাদের কাছে অ্যাপ সংস্করণ রয়েছে 2.0.0 এবং ডাটাবেস ইন v2.

ধাপ:

1. সংস্করণে আপনার অ্যাপ্লিকেশন রোল ব্যাক 1.0.0.
2. সংস্করণ 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

ডিবি সংস্করণ:v3

মন্তব্য

বিঃদ্রঃ প্রতি.: স্পষ্টতই, মূল নিবন্ধে লেখক ভুলবশত এই ব্লকের টেক্সটটি ধাপ 2 থেকে অনুলিপি করেছেন। এই ধাপে, কলাম ব্যবহার করে এমন কার্যকারিতা অপসারণের লক্ষ্যে অ্যাপ্লিকেশন কোডে পরিবর্তন করা উচিত। last_name.

একটি নতুন কলাম যোগ করে এবং এর বিষয়বস্তু অনুলিপি করে, আমরা পিছনের দিকে সামঞ্জস্যপূর্ণ ডাটাবেস পরিবর্তন তৈরি করেছি। এছাড়াও, যদি আমরা JAR রোলব্যাক করি বা একটি পুরানো JAR চলমান থাকে তবে এটি কার্যকর করার সময় ভেঙে যাবে না।

অ্যাপ্লিকেশন রোলব্যাক

বর্তমানে আমাদের কাছে অ্যাপ সংস্করণ রয়েছে 3.0.0 এবং ডাটাবেস v3. সংস্করণ 3.0.0 ডেটা সংরক্ষণ করে না last_name. এর মানে হল যে surname সবচেয়ে আপ টু ডেট তথ্য সংরক্ষণ করা হয়.

ধাপ:

1. সংস্করণে আপনার অ্যাপ্লিকেশন রোল ব্যাক 2.0.0.
2. সংস্করণ 2.0.0 ব্যবহার করে এবং last_name и surname.
3. সংস্করণ 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;

কোড পরিবর্তন

বিঃদ্রঃ প্রতি।: এই ব্লকের বর্ণনাটিও লেখক ভুলবশত ২য় ধাপ থেকে অনুলিপি করেছেন। নিবন্ধের যুক্তি অনুসারে, এই ধাপে কোডে পরিবর্তনের লক্ষ্য হওয়া উচিত কলামের সাথে কাজ করে এমন উপাদানগুলিকে সরিয়ে ফেলা। 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

ডিবি সংস্করণ: 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. অ্যাপ্লিকেশন সংস্করণ স্থাপনা 1.0.0 с v1 ডাটাবেস স্কিমা (কলামের নাম = last_name)
2. অ্যাপ্লিকেশন সংস্করণ স্থাপনা 2.0.0, যা তথ্য সংরক্ষণ করে last_name и surname. আবেদন থেকে পড়া last_name. ডাটাবেস সংস্করণে আছে v2মত কলাম ধারণকারী last_name, এবং surname. surname l এর একটি অনুলিপিast_name. (দ্রষ্টব্য: এই কলামে অবশ্যই নাল সীমাবদ্ধতা থাকবে না)
3. অ্যাপ্লিকেশন সংস্করণ স্থাপনা 3.0.0, যা শুধুমাত্র ডেটা সঞ্চয় করে surname এবং উপাধি থেকে পড়ে। ডাটাবেসের জন্য, শেষ মাইগ্রেশন হচ্ছে last_name в surname. এছাড়াও একটি সীমাবদ্ধতা নাল না থেকে সরানো হয়েছে last_name. ডাটাবেস এখন সংস্করণে আছে v3
4. অ্যাপ্লিকেশন সংস্করণ স্থাপনা 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 কনসোলও অন্তর্ভুক্ত রয়েছে (এ http://localhost:8080/h2-console) যাতে আপনি ডাটাবেসের স্থিতি দেখতে পারেন (ডিফল্ট jdbc URL হল jdbc:h2:mem:testdb).

অতিরিক্ত

• ডাটাবেস রিফ্যাক্টরিং প্যাটার্ন
• অবিচ্ছিন্ন বিতরণ

এছাড়াও আমাদের ব্লগে অন্যান্য নিবন্ধ পড়ুন:

• কুবারনেটস: সিস্টেম রিসোর্স ম্যানেজমেন্ট কনফিগার করা কেন এত গুরুত্বপূর্ণ?
• টেকটন পাইপলাইন - কুবারনেটেস-নেটিভ পাইপলাইন
• Nginx এর জন্য গতিশীল মডিউল তৈরি করা
• Hashicorp কনসাল এর Kubernetes অনুমোদনের ভূমিকা
• অনুমোদন ছাড়াই ClickHouse থেকে ClickHouse-এ অনুমোদন সহ মাইগ্রেশন কিসের দিকে নিয়ে গেছে?
• Nginx ওয়েব সার্ভারের সাথে স্প্রিং অ্যাপ্লিকেশনগুলির নীল-সবুজ স্থাপনা

উত্স: www.habr.com