{"id":96529,"date":"2023-09-11T19:00:08","date_gmt":"2023-09-11T17:00:08","guid":{"rendered":"https:\/\/artigianodelsoftware.it\/blog\/?p=96529"},"modified":"2023-09-11T19:00:10","modified_gmt":"2023-09-11T17:00:10","slug":"manteniamo-sincronizzati-i-nostri-space-di-confluence","status":"publish","type":"post","link":"https:\/\/artigianodelsoftware.it\/blog\/2023\/09\/11\/manteniamo-sincronizzati-i-nostri-space-di-confluence\/","title":{"rendered":"Manteniamo sincronizzati i nostri Space di Confluence"},"content":{"rendered":"
\"image_pdf\"<\/a><\/a><\/div>\n

In questo post andremo ad esaminare come possiamo gestire una sincronizzazione di Space, sia nella stessa istanza, che su istanze differenti. Andiamo in modalit\u00e0 esplorativa <\/p>\n\n\n\n

\"\"
Vestiamo i panni del moderno alchimista<\/figcaption><\/figure>\n\n\n\n

Introduzione dello scenario<\/h2>\n\n\n\n

Lo scenario che mi piacerebbe implementare serve nel caso di problemi che si possono presentare nella istanza di produzione. Se abbiamo a disposizione una istanza, minore con un numero inferiore di utenti, possiamo avere un backup sempre pronto all’uso che ci permette di poter ripristinare in tempi brevi l’operativit\u00e0, permettendoci poi di ripristinare tutti gli aggiornamenti nel caso di riattivazione dell’ambiente di produzione. <\/p>\n\n\n\n

Questo articolo rientra in un insieme di studi che sono nati dopo che ho pubblicato questo articolo<\/a>, visto che sono stato uno dei fortunati a ricevere questa situazione. Per questo motivo voglio avere delle alternative da poter ottenere un esempio di Disaster Recovery anche per le nostre istanze Atlassian Cloud.<\/p>\n\n\n\n

\"\"
Vediamo in questo articolo come riuscire a creare un ambiente di Disaster Recovery<\/figcaption><\/figure>\n\n\n\n

Come possiamo eseguire questa operazione?<\/h2>\n\n\n\n

Analizzando il Marketplace, operazione che eseguiamo quotidianamente, identifichiamo il seguente addon che ci permette di eseguire la sincronizzazione di due space relativi a due istanze Cloud differenti.<\/p>\n\n\n\n

In questo caso abbiamo un addon che ci pu\u00f2 aiutare. <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Andiamo ad esaminarlo. <\/p>\n\n\n\n

Che cosa offre l’addon<\/h2>\n\n\n\n

L’addon permette di eseguire una sincronizzazione da uno Space all’altro, nell’ambito di una stessa istanza, ma anche su istanze differenti. Questa funzionalit\u00e0 ci permette di poter creare degli scenari non indifferenti, permettendo di creare degli ambienti di Disaster Recovery, ma non solo. possiamo anche sfruttare questa funzionalit\u00e0 anche in scenari in cui dobbiamo gestire l’approvazione dei contenuti. Le idee scorrono potenti \ud83d\ude42 <\/p>\n\n\n\n

\"\"
Questa volta ci vuole \ud83d\ude1b<\/figcaption><\/figure>\n\n\n\n

Il seguente schema riassume il funzionamento e ci permette di capire come ragiona l’addon<\/p>\n\n\n\n

\"\"
Fonte: Marketplace Atlassian<\/figcaption><\/figure>\n\n\n\n

Osserviamo che la sincronizzazione, una volta impostata, \u00e8 bidirezionale, di conseguenza qualsiasi operazione eseguita in uno degli Space viene immediatamente riverberata sugli altri. Non solo. Oltre alla sincronizzazione completa dello Space, abbiamo anche la sincronizzazione della singola pagina, come vediamo dalla seguente figura:<\/p>\n\n\n\n

\"\"
Fonte: Marketplace Atlassian<\/figcaption><\/figure>\n\n\n\n

dove vediamo tutti i collegamenti impostati e abbiamo la possibilit\u00e0 di poter sincronizzare anche le singole pagine. La stessa interfaccia ci permette di capire se abbiamo eseguito l’aggiornamento della pagina o meno.<\/p>\n\n\n\n

\"\"
Fonte: Marketplace Atlassian<\/figcaption><\/figure>\n\n\n\n

La configurazione non risulta impossibile, sempre guardando le schermate che sono presenti sul Marketplace. Viene fatto uso di Token per rendere sicura la sincronizzazione.<\/p>\n\n\n\n

Convinto subito: Lo provo.<\/h2>\n\n\n\n

Iniziamo quindi a Installare l’addon. Come sempre ci serviamo di una GIF animata per vedere come eseguire l’installazione dell’addon.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Nota Bene<\/strong> – Lo installo ovviamente su due istanze per poi anche provare la sincronizzazione tra due istanze cloud differenti.<\/p>\n\n\n\n

Andiamo ad analizzare subito la configurazione generale, cui accediamo dal men\u00f9 Apps<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Che ci mostra l’elenco degli space disponibili e ci fornisce il link diretto alla configurazione, che ci permette di poter accedere alla configurazione diretta dell’addon che \u00e8 presente nelle configurazioni dei singoli Space<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Se selezioniamo Edit sync settings<\/strong> veniamo reindirizzati alla pagina di configurazione vera e propria. <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

La configurazione di una sincronizzazione non richiede tantissimo. Semplicemente definiamo una sincronizzazione in quello che \u00e8 lo Space sorgente. Da questo andiamo a scaricare il Token (\u00e8 un file JMT), che andremo a caricare nella configurazione dello Space Destinazione.<\/p>\n\n\n\n

A questo punto ho creato prima una sincronizzazione tra due Space di una stessa istanza e successivamente una sincronizzazione tra due istanze. A tale scopo ho due istanze Cloud dedicate allo scopo che ho preparato per un test che \u00e8 diventato questo Case Study<\/a>. Mi sono quindi limitato a configurare e a verificare<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Ho scelto questi Space perch\u00e9 presentavano delle informazioni differenti ed ho verificato come si comportavano.<\/p>\n\n\n\n

\"\"
Un esempio di esecuzione negli ambienti di test Cloud<\/figcaption><\/figure>\n\n\n\n

Come possiamo vedere dalla GIF animata, l’esecuzione \u00e8 molto semplice e non abbiamo molti output. Lo stesso LOG non ha dato alcun risultato e non abbiamo nulla da vedere dopo. Questo \u00e8 un punto importante.<\/p>\n\n\n\n

Anche l’esecuzione della parte multiistanza non presenta molti problemi:<\/p>\n\n\n\n

\"\"
Esecuzione sincronizzazione della multiistanza<\/figcaption><\/figure>\n\n\n\n

Vediamo che il risultato mostrato \u00e8 il medesimo.<\/p>\n\n\n\n

Andando ad analizzare il tutto, vediamo che le operazioni hanno sincronizzato le pagine, ma ho notato una cosa: La Homepage degli Space non viene sincronizzata. <\/p>\n\n\n\n

Infatti Il mio space ‘sorgente’ ha questa homepage<\/p>\n\n\n\n

\"\"
Lo Space ‘Commerciale’<\/figcaption><\/figure>\n\n\n\n
\"\"
Lo space privato del mio utente, usato come Space destinazione<\/figcaption><\/figure>\n\n\n\n

Osserviamo che per la Homepage non abbiamo a disposizione alcun men\u00f9 che ci mostra lo stato della sincronizzazione. Mentre per le altre pagine abbiamo tale funzione disponibile.<\/p>\n\n\n\n

\n
\n
\"\"
La pagina con la dialog box indicante lo stato della sincronizzazione<\/figcaption><\/figure>\n<\/div>\n\n\n\n
\n
\"\"
La pagina con la Dialog box indicante lo stato della sincronizzazione<\/figcaption><\/figure>\n\n\n\n

<\/p>\n<\/div>\n<\/div>\n\n\n\n

Vediamo la stessa pagina con la Dialog box sui due spazi distinti. Lo stesso risultato lo abbiamo anche quando usiamo la sincronizzazione su multistanza.<\/p>\n\n\n\n

Risultato del test<\/h2>\n\n\n\n

Il risultato \u00e8 sicuramente positivo ma ho notato alcune cose. Sono abbastanza sicuro del perch\u00e9 ci sia il comportamento che ho notato, ma voglio esserne sicuro e quindi lo evidenzio qui. Sono sicuro che gli autori dell’addon mi confermeranno le ipotesi.<\/p>\n\n\n\n

    \n
  1. La Home page dello Space non risulta inclusa nella sincronizzazione. <\/li>\n\n\n\n
  2. La sincronizzazione avviene copiando dallo Space origine verso lo Space destinazione<\/li>\n\n\n\n
  3. Non vedo i log delle operazioni, sia quando sono in esecuzione sia quando sono concluse le operazioni di sincronizzazione<\/li>\n<\/ol>\n\n\n\n

    La Homepage non viene sincronizzata ma ho il dubbio che, per come \u00e8 organizzato Confluence, l’addon non riesca ancora ad eseguire questa operazione. <\/p>\n\n\n\n

    Eseguire la sincronizzazione in una direzione piuttosto che in entrambe le direzioni non lo vedo come un problema. Nello scenario che ci siamo posti come obiettivo, non \u00e8 affatto un problema in quanto prima di usa una delle due istanze come Disaster Recovery e di conseguenza la sincronizzazione \u00e8 in una direzione. Solo dopo pu\u00f2 essere necessario sincronizzare nella direzione inversa in quanto, nel caso in cui la produzione non risponde, allora serve la sincronizzazione per ripristinare la produzione.<\/p>\n\n\n\n

    Cosa pi\u00f9 importante sono i LOG. Il fatto che non riesca a vederli durante l’esecuzione e poi a sincronizzazione eseguita, lo vedo come un problema. Nel caso di malfunzionamento, occorre sempre capire la causa e i LOG sono fondamentali. Di conseguenza questo punto deve essere visto dai produttori dell’addon in modo da renderlo disponibile sempre e anche facilmente consultabile.<\/p>\n\n\n\n

    Conclusione<\/h2>\n\n\n\n

    Il mio giudizio \u00e8 sempre positivo: abbiamo un addon molto interessante, anche se non riusciamo in pieno ad implementare la soluzione del Disaster recovery. Il fatto di non riuscire a copiare per intero la pagina iniziale dello Space, non \u00e8 proprio il massimo, ma non ci scoraggiamo. Abbiamo uno strumento in pi\u00f9 da poter usare per i nostri obiettivi. Non abbiamo uno strumento che esegue perfettamente la sincronizzazione come ci aspettiamo, ma riusciamo comunque ad avere un risultato che ci si avvicina. In aggiunta ci vedo un altro possibile utilizzo: quando gestiamo una documentazione e abbiamo un processo abbastanza complesso di approvazione delle modifiche, quello che possiamo fare \u00e8 usare 2 space: uno per la documentazione ufficiale e uno per redigere le modifiche. Quando la modifica viene approvata, questa viene sincronizzata con lo Space ufficiale. Quindi, questo ci deve insegnare a non abbandonare un addon se non esegue proprio quello che ci interessa, ma semplicemente lo andiamo ad applicare ad altre situazioni<\/p>\n\n\n\n

    Reference<\/h2>\n\n\n\n

    Maggiori informazioni sono disponibili alla pagina del Marketplace<\/a><\/p>\n

    Likes(0<\/span>)<\/span>Dislikes(0<\/span>)<\/span><\/div>","protected":false},"excerpt":{"rendered":"

    In questo post andremo ad esaminare come possiamo gestire una sincronizzazione di Space, sia nella stessa istanza, che su istanze differenti. Andiamo in modalit\u00e0 esplorativa Introduzione dello scenario Lo scenario che mi piacerebbe implementare serve nel caso di problemi che<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_editorskit_title_hidden":false,"_editorskit_reading_time":0,"_editorskit_is_block_options_detached":false,"_editorskit_block_options_position":"{}","footnotes":""},"categories":[3,4,7,180],"tags":[30,34,35,48,89],"_links":{"self":[{"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/posts\/96529"}],"collection":[{"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/comments?post=96529"}],"version-history":[{"count":13,"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/posts\/96529\/revisions"}],"predecessor-version":[{"id":96764,"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/posts\/96529\/revisions\/96764"}],"wp:attachment":[{"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/media?parent=96529"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/categories?post=96529"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/tags?post=96529"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}