Aviso: o nó de substituição precisa usar um nome do host que ainda não tenha sido usado no cluster para evitar conflitos.
Substituir um nó funcional
-
Provisione e instale GitHub Enterprise Server com um nome de host exclusivo no nó de substituição. 1. Usando o shell administrativo ou o DHCP, configure apenas o endereço IP do nó de substituição. Não altere nenhuma outra configuração. 1. Para adicionar o nó de substituição recém-provisionado, em qualquer nó, modifique o arquivo
cluster.conf
para remover o nó com falha e adicione o nó de substituição. Por exemplo, este arquivocluster.conf
modificado substituighe-data-node-3
pelo nó recém-provisionado,ghe-replacement-data-node-3
:[cluster "ghe-replacement-data-node-3"] hostname = ghe-replacement-data-node-3 ipv4 = 192.168.0.7 # ipv6 = fd12:3456:789a:1::7 git-server = true pages-server = true mysql-server = true elasticsearch-server = true redis-server = true memcache-server = true metrics-server = true storage-server = true
1. No shell administrativo do nó com o `cluster.conf` modificado, execute `ghe-cluster-config-init`. Isto irá inicializar o nó recém-adicionado no cluster. 1. No mesmo nó, execute `ghe-cluster-config-apply`. Isso vai validar o arquivo de configuração, copiá-lo para cada nó no cluster e configurar cada nó de acordo com o arquivo `cluster.conf` modificado. 1. Se você estiver colocando um nó offline que tenha `git-server = true` definido em cluster.conf, evacue o nó. Para obter mais informações, confira "[Como evacuar um nó de cluster](/enterprise/admin/clustering/evacuating-a-cluster-node)". 1. Para marcar o nó com falha offline, em qualquer nó, modifique o [arquivo de configuração do cluster](/enterprise/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file) (`cluster.conf`) na seção de nó relevante para incluir o texto `offline = true`.Por exemplo, este
cluster.conf
modificado marcará o nóghe-data-node-3
como offline:[cluster "ghe-data-node-3"] hostname = ghe-data-node-3 offline = true ipv4 = 192.168.0.6 # ipv6 = fd12:3456:789a:1::6
1. No shell administrativo do nó em que você modificou `cluster.conf`, execute `ghe-cluster-config-apply`. Isso irá validar o arquivo de configuração, copiá-lo para cada nó do cluster e marcar o nó offline. 1. Se você estiver substituindo o nó MySQL ou Redis principal no `cluster.conf`, modifique o valor `mysql-master` ou `redis-master` pelo nome do nó de substituição.Por exemplo, esse arquivo
cluster.conf
modificado especifica um nó de cluster recém-provisionado,ghe-replacement-data-node-1
como o nó do MySQL e e Redis principal:mysql-master = ghe-replacement-data-node-1 redis-master = ghe-replacement-data-node-1
Substituir um nó em caso de emergência
-
Provisione e instale GitHub Enterprise Server com um nome de host exclusivo no nó de substituição. 1. Usando o shell administrativo ou o DHCP, configure apenas o endereço IP do nó de substituição. Não altere nenhuma outra configuração. 1. Para marcar o nó com falha offline, em qualquer nó, modifique o arquivo de configuração do cluster (
cluster.conf
) na seção de nó relevante para incluir o textooffline = true
.Por exemplo, este
cluster.conf
modificado marcará o nóghe-data-node-3
como offline:[cluster "ghe-data-node-3"] hostname = ghe-data-node-3 offline = true ipv4 = 192.168.0.6 # ipv6 = fd12:3456:789a:1::6
1. No shell administrativo do nó em que você modificou `cluster.conf`, execute `ghe-cluster-config-apply`. Isso irá validar o arquivo de configuração, copiá-lo para cada nó do cluster e marcar o nó offline. 1. Para adicionar o nó de substituição recém-provisionado, em qualquer nó, modifique o arquivo `cluster.conf` para remover o nó com falha e adicione o nó de substituição. Por exemplo, este arquivo `cluster.conf` modificado substitui `ghe-data-node-3` pelo nó recém-provisionado, `ghe-replacement-data-node-3`:[cluster "ghe-replacement-data-node-3"] hostname = ghe-replacement-data-node-3 ipv4 = 192.168.0.7 # ipv6 = fd12:3456:789a:1::7 git-server = true pages-server = true mysql-server = true elasticsearch-server = true redis-server = true memcache-server = true metrics-server = true storage-server = true
1. Se você estiver substituindo o nó MySQL ou Redis principal no `cluster.conf`, modifique o valor `mysql-master` ou `redis-master` pelo nome do nó de substituição.Por exemplo, esse arquivo
cluster.conf
modificado especifica um nó de cluster recém-provisionado,ghe-replacement-data-node-1
como o nó do MySQL e e Redis principal:mysql-master = ghe-replacement-data-node-1 redis-master = ghe-replacement-data-node-1
1. No shell administrativo do nó com o `cluster.conf` modificado, execute `ghe-cluster-config-init`. Isto irá inicializar o nó recém-adicionado no cluster. 1. No mesmo nó, execute `ghe-cluster-config-apply`. Isso vai validar o arquivo de configuração, copiá-lo para cada nó no cluster e configurar cada nó de acordo com o arquivo `cluster.conf` modificado. 1. Se você estiver colocando um nó offline que tenha `git-server = true` definido em cluster.conf, evacue o nó. Para obter mais informações, confira "[Como evacuar um nó de cluster](/enterprise/admin/clustering/evacuating-a-cluster-node)".