show how to remove a component

tsa/howto/static-component.mdwn

@@ -71,3 +71,41 @@ Adding a new component
     This, for example, is the line that was added for `onionperf`:
     
         %torwww,%metrics		STATICMASTER=(mirroradm)	NOPASSWD: /usr/local/bin/static-master-update-component onionperf.torproject.org, /usr/local/bin/static-update-component onionperf.torproject.org
+
+Removing a component
+====================
+
+ 1. remove the component to Puppet, in `modules/roles/misc/static-components.yaml`
+
+ 2. create the home directory specified on the server (often
+    `staticiforme`, but can be elsewhere)
+
+ 3. remove the host to DNS, if not already present, see [[dns]]. this
+    can be either in `dns/domains.git` or `dns/auto-dns.git`
+
+ 4. remove the Apache virtual host, by removing a line like this in
+    [[puppet]] to
+    `modules/roles/templates/static-mirroring/vhost/static-vhosts.erb`:
+
+        vhost(lines, 'onionperf.torproject.org')
+
+ 5. remove an SSL service, by removing a line in [[puppet]] to
+    `modules/roles/manifests/static_mirror_web.pp`:
+
+        ssl::service { onionperf.torproject.org': ensure => 'ifstatic', notify  => Exec['service apache2 reload'], key => true, }
+
+ 6. remove the Let's encrypt certificate, see [[letsencrypt]] for details
+
+ 7. remove onion service, by removing another `onion::service` line in
+    [[puppet]] to `modules/roles/manifests/static_mirror_onion.pp`:
+
+        onion::service {
+            [...]
+            'onionperf.torproject.org',
+            [...]
+        }
+
+ 8. remove the sudo rules for the role user
+ 
+ 9. consider removing the role user and group in LDAP, if there are no
+    files left owned by that user