feat: allow recreating ssh key when public key in the API does not match (#634)

##### SUMMARY

- Log a warning when the provided public key does not match one in the
API.
- When the public key does not match the one in the API, allow
recreating the SSH Key in the API using the ``force=true`` argument.


Closes: #578 

##### ISSUE TYPE
- Feature Pull Request

##### COMPONENT NAME
<!--- Write the short name of the module, plugin, task or feature below
-->
`ssh_key`

##### ADDITIONAL INFORMATION
In Hetzner API, we do not have any public_key change endpoint and only
updating names and labels are allowed.
For public_key The only way is removing and re-creating. `force` option
allows users to do re-creation if needed.

---------

Co-authored-by: jo <ljonas@riseup.net>

tests/integration/targets/setup_ssh_keypair/tasks/main.yml

@@ -17,3 +17,15 @@
     path: "{{ _tmp_ssh_key_file.path }}"
     force: true
   register: test_ssh_keypair
+
+- name: Create temporary file for test_ssh_keypair2
+  ansible.builtin.tempfile:
+    path: ~/tmp
+    suffix: "{{ hcloud_ssh_key_name }}"
+  register: _tmp_ssh_key_file2
+
+- name: Create test_ssh_keypair2
+  community.crypto.openssh_keypair:
+    path: "{{ _tmp_ssh_key_file2.path }}"
+    force: true
+  register: test_ssh_keypair2

tests/integration/targets/ssh_key/tasks/test.yml

@@ -93,7 +93,7 @@
       key: value
       test: "val123"
   register: result
-- name: test update ssh key  with other labels
+- name: test update ssh key with other labels
   assert:
     that:
       - result is changed
@@ -136,9 +136,45 @@
       - result is failed
       - result.failure.code == "uniqueness_error"
 
+- name: test update public key warning
+  hetzner.hcloud.ssh_key:
+    name: "{{ hcloud_ssh_key_name }}"
+    public_key: "{{ test_ssh_keypair2.public_key }}"
+  register: result
+- name: verify update public key warning
+  assert:
+    that:
+      - result is not changed
+      - result.hcloud_ssh_key.name == hcloud_ssh_key_name
+      - result.hcloud_ssh_key.public_key == test_ssh_keypair.public_key
+
+- name: test update public key with force
+  hetzner.hcloud.ssh_key:
+    name: "{{ hcloud_ssh_key_name }}"
+    public_key: "{{ test_ssh_keypair2.public_key }}"
+    force: true
+  register: result
+- name: verify update public key with force
+  assert:
+    that:
+      - result is changed
+      - result.hcloud_ssh_key.name == hcloud_ssh_key_name
+      - result.hcloud_ssh_key.public_key == test_ssh_keypair2.public_key
+
+- name: test update public key with force idempotence
+  hetzner.hcloud.ssh_key:
+    name: "{{ hcloud_ssh_key_name }}"
+    public_key: "{{ test_ssh_keypair2.public_key }}"
+    force: true
+  register: result
+- name: verify update public key with force idempotence
+  assert:
+    that:
+      - result is not changed
+
 - name: test delete ssh key
   hetzner.hcloud.ssh_key:
-    id: "{{ ssh_key.hcloud_ssh_key.id }}"
+    name: "{{ hcloud_ssh_key_name }}"
     state: absent
   register: result
 - name: verify absent ssh_key