Drush की मदद से अपडेट

Drush Drupal के लिए एक कमांड-लाइन शेल और स्क्रिप्टिंग इंटरफ़ेस है। Drush का उपयोग करके Drupal 8 में अपग्रेड करना ब्राउज़र यूज़र इंटरफ़ेस का उपयोग करने का एक विकल्प है। Drush का उपयोग करके Drupal 8 में अपग्रेड करना जटिल साइटों के माइग्रेशन के समय बहुत उपयोगी होता है, क्योंकि यह माइग्रेशन को एक-एक करके चलाने और रोलबैक करने की अनुमति देता है।

Composer के साथ Drush इंस्टॉल करना

Drupal 8 साइटें Composer के साथ बनाई जा सकती हैं। यदि आप drupal-composer/drupal-project को Composer प्रोजेक्ट टेम्पलेट के रूप में उपयोग करते हैं, तो आपके पास पहले से ही Drush होगा, क्योंकि यह प्रोजेक्ट की composer.json फ़ाइल में एक निर्भरता के रूप में सूचीबद्ध होता है।

यदि आपके Composer प्रोजेक्ट में Drush एक निर्भरता के रूप में सूचीबद्ध नहीं है, तो आप इसे कमांड लाइन से इस तरह इंस्टॉल कर सकते हैं:

composer require drush/drush

नोट: अभी Drush 9 का उपयोग करें

Drush 10 के साथ समस्या के कारण, इस समय यह अनुशंसा की जाती है कि आप composer का उपयोग करके Drush 9 स्थापित करें, drush/drush: ^9.0 की आवश्यकता रखते हुए, जिससे संस्करण 9.7.2 प्राप्त होता है।

यह आपको नवीनतम (स्थिर) Drush देगा, जो नवीनतम Drupal के साथ संगत होना चाहिए। अधिक जानकारी के लिए देखें Drush और Drupal संस्करण संगतता मैट्रिक्स।

अपनी Drush संस्करण की जांच करने के लिए उपयोग करें:

drush --version

अनिवार्य Drupal मॉड्यूल

Drush का उपयोग करके माइग्रेशन करने के लिए, आपको निम्नलिखित contributed मॉड्यूल डाउनलोड और सक्षम करने होंगे:

• Migrate Upgrade: Drupal 6 या 7 से Drupal 8 में अपग्रेड के लिए Drush समर्थन प्रदान करता है।
• Migrate Plus: माइग्रेशन इंजन की बेसिक कार्यक्षमता के लिए एक्सटेंशन प्रदान करता है।
• Migrate Tools: Drush कमांड्स प्रदान करता है, जिनका उपयोग इस पेज में बाद में किया गया है।

महत्वपूर्ण! प्रत्येक मॉड्यूल के लिए सही संस्करण का चयन करने पर विशेष ध्यान दें। कृपया उस प्रोजेक्ट पेज से परामर्श करें जो आपके Drupal 8 कोर संस्करण के साथ संगत संस्करण सूचीबद्ध करता है।

विभिन्न अपग्रेड मॉड्यूल्स के बारे में अधिक जानकारी के लिए कृपया देखें अपग्रेड मॉड्यूल्स की सूची।

स्रोत डेटाबेस को परिभाषित करना

यह उदाहरण दिखाता है कि अपने स्रोत Drupal 6/7 साइट के लिए डेटाबेस कनेक्शन विवरण कैसे परिभाषित करें। यदि आपकी स्रोत साइट एक डेटाबेस प्रीफ़िक्स का उपयोग करती है, तो सुनिश्चित करें कि आप प्रीफ़िक्स निर्दिष्ट करें। आपको अपनी लोकल डेवलपमेंट डेटाबेस (default) और स्रोत डेटाबेस (D6 या D7) दोनों से कनेक्ट करना होगा। नीचे Lando के साथ ऐसा करने का एक उदाहरण है। उदाहरण में पूर्णता के लिए डिफ़ॉल्ट डेटाबेस शामिल है।

नोट: समस्याओं से बचने के लिए, यह महत्वपूर्ण है कि माइग्रेशन डेटाबेस कुंजी को “migrate” नाम दिया जाए। देखें Drupal 7 कोर संस्करण माइग्रेशन के दौरान फील्ड फेल्योर।

settings.php में डेटाबेस कनेक्शन का उदाहरण

$databases['default']['default'] = [
  'database' => 'drupal8',
  'username' => 'drupal8',
  'password' => 'drupal8',
  'prefix' => '',
  'host' => 'database',
  'port' => '3306',
  'namespace' => 'Drupal\\Core\\Database\\Driver\\mysql',
  'driver' => 'mysql',
];

$databases['migrate']['default'] = [
  'database' => 'drupal7db',
  'username' => 'drupal7db',
  'password' => 'drupal7db',
  'prefix' => '',
  'host' => 'd7db',
  'port' => '3306',
  'namespace' => 'Drupal\\Core\\Database\\Driver\\mysql',
  'driver' => 'mysql',
];

Example .lando.yml

name: mywebsite
recipe: drupal8
config:
  webroot: web

# Create Drupal 7 database service, consider adding phpmyadmin
services:
  d7db:
    type: mariadb
    creds:
      user: drupal7db
      password: drupal7db
      database: drupal7db
    portforward: true

Drupal 7 डेटाबेस आयात करें, यह मानते हुए कि डेटाबेस डंप फ़ाइल का नाम mywebsite_db.sql.gz है और वर्तमान फ़ोल्डर में है:

lando db-import --host=d7db --user=drupal7db mywebsite_db.sql.gz

प्रेरणा से लिया गया: https://github.com/thinktandem/migration_boilerplate.

migrate-upgrade का उपयोग करके माइग्रेशन जनरेट करना

Migrate Tools मॉड्यूल Drush कमांड्स जोड़ता है जैसे कि drush migrate-status और drush migrate-import। माइग्रेशन से संबंधित सभी Drush कमांड्स की पूरी सूची इस पेज के नीचे पाई जा सकती है।

यदि आप बिना कुछ किए drush migrate-status कमांड चलाते हैं, तो आपको कोई उपलब्ध माइग्रेशन दिखाई नहीं देगा। ऐसा इसलिए है क्योंकि माइग्रेशन को पहले आपकी स्रोत डेटाबेस के आधार पर जनरेट किया जाना चाहिए। चूंकि Migrate को यह नहीं पता कि कौन सा स्रोत उपयोग करना है, माइग्रेशन अभी तक बनाए नहीं गए हैं।

माइग्रेशन जनरेट करने के लिए आपको Drush कमांड drush migrate-upgrade की आवश्यकता होगी, जो Migrate Upgrade मॉड्यूल द्वारा प्रदान किया जाता है।

आमतौर पर, आप केवल व्यक्तिगत माइग्रेशन जनरेट करना चाहेंगे, ताकि आप उन्हें एक-एक करके चला सकें। यदि ऐसा है, तो आपको --configure-only विकल्प का उपयोग करना होगा।

drush migrate-upgrade --legacy-db-url=mysql://user:password@server/db --legacy-root=http://example.com --configure-only

जहाँ:

• 'user' स्रोत डेटाबेस का उपयोगकर्ता नाम है।
• 'password' स्रोत डेटाबेस उपयोगकर्ता का पासवर्ड है।
• 'server' स्रोत डेटाबेस सर्वर है।
• 'db' स्रोत डेटाबेस है।
• 'http://example.com' आपकी स्रोत साइट की रूट है। यदि पुरानी साइट लोकल फाइल सिस्टम पर है, तो आप Drupal रूट डायरेक्टरी का पथ उपयोग कर सकते हैं। यहाँ दिया गया मान व्यक्तिगत फ़ाइल पथों में जोड़ा जाएगा ताकि उन्हें ढूँढा और आयात किया जा सके।

--legacy-db-key विकल्प आपको settings.php में परिभाषित संबंधित कुंजी वाले $database ऐरे का उपयोग करने देता है।

यदि आपकी स्रोत साइट टेबल प्रीफ़िक्स का उपयोग करती है, तो आपको इसे एक अतिरिक्त आर्ग्यूमेंट के रूप में जोड़ना होगा। उदाहरण:

drush migrate-upgrade --legacy-db-url=mysql://user:password@server/db --legacy-db-prefix=drupal_ --legacy-root=http://example.com --configure-only

यदि आप --configure-only का उपयोग नहीं करते हैं, तो drush migrate-upgrade पहले माइग्रेशन जनरेट करेगा और फिर उन्हें निष्पादित करेगा।

--configure-only पैरामीटर के साथ migrate-upgrade चलाने के बाद, आप migrate-status चलाएँगे ताकि संभावित माइग्रेशन की सूची देख सकें:

drush migrate-status

इसके बाद आप इन माइग्रेशन की समीक्षा कर सकते हैं और उन्हें चयनात्मक रूप से चला सकते हैं। किसी माइग्रेशन को व्यक्तिगत रूप से चलाने के लिए चलाएँ:

drush migrate-import <migration name>

सभी माइग्रेशन को सूची में चलाने के लिए चलाएँ:

drush migrate-import --all