split tutorial

Author: Laure-di

tutorials/how-to-setup-applesilicon-server-with-ansible/index.mdx

@@ -1,36 +1,35 @@
 ---
 meta:
-    title: Automating Apple Silicon Server Creation: A Step-by-Step Guide Using Terraform vs. Ansible
-    description: Explore Two Powerful Approaches to Automating Apple Silicon Server Deployment with Terraform and Ansible
+    title: Automating Apple Silicon Server Creation: A Step-by-Step Guide Using Terraform
+    description: Explore Two Powerful Approaches to Automating Apple Silicon Server Deployment with Terraform
 content:
-    h1: Automating Apple Silicon Server Creation: A Step-by-Step Guide Using Terraform vs. Ansible
-    description: Explore Two Powerful Approaches to Automating Apple Silicon Server Deployment with Terraform and Ansible
+    h1: Automating Apple Silicon Server Creation: A Step-by-Step Guide Using Terraform
+    description: Explore Two Powerful Approaches to Automating Apple Silicon Server Deployment with Terraform
 categories:
     - apple-silicon
     - terraform
-    - ansible
-tags: apple-silicon terraform ansible
+tags: apple-silicon ansible
 ---
 
-In this tutorial, we will guide you through automating the setup and management of Apple Silicon servers using two powerful tools: [Terraform](https://www.terraform.io/) and [Ansible](https://www.ansible.com/). By leveraging these tools, you can streamline infrastructure management, reduce manual configuration, and ensure consistent environments.
+In this tutorial, we will guide you through automating the setup and management of Apple Silicon servers using a powerful tool: [Terraform](https://www.terraform.io/). By leveraging these tools, you can streamline infrastructure management, reduce manual configuration, and ensure consistent environments.
 
 <Macro id="requirements" />
 
 - A Scaleway account logged into the [console](https://console.scaleway.com)
 - [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
 - A valid [API key](/identity-and-access-management/iam/how-to/create-api-keys/)
 
-## Understanding the tools
+## Understanding the tool
+
+### HashiCorp Terraform & OpenTofu
 
-### HashiCorp Terraform
 [Terraform](https://www.terraform.io/) is an open-source Infrastructure as Code (IaC) tool that allows you to define and manage infrastructure using declarative configuration files. Terraform enables you to create reproducible and scalable environments while automating the deployment of resources.
 
-### Ansible
-[Ansible](https://www.ansible.com/) is an automation tool that simplifies configuration management, application deployment, and task automation. By using playbooks, Ansible helps automate and streamline processes, ensuring consistency and efficiency in managing complex infrastructure.
+A fork of this project, [OpenTofu](https://opentofu.org/), is an open-source alternative that aims to be fully compatible with Terraform, while offering an independent, community-driven approach. OpenTofu provides the same functionality as Terraform, allowing users to define infrastructure with HCL (HashiCorp Configuration Language) and automate resource management. Its goal is to offer a transparent and open solution, with an emphasis on inclusivity and community contributions.
 
-## How to create an Apple silicon server
+Both Terraform and OpenTofu offer the same core functionality for provisioning and managing infrastructure. If you are familiar with Terraform, you can easily switch to OpenTofu without needing to change your configuration files.
 
-### Using Terraform
+## How to create an Apple silicon server
 
 1. Download and install [Terraform](https://developer.hashicorp.com/terraform/install).
 
@@ -116,88 +115,51 @@ terraform apply
 
 This will apply the new settings, ensuring that the server is launched within the specified VPC and connected to the Private Network.
 
-### Using Ansible
-
-1. Install Ansible:  If you don't have Ansible installed on your system, you can easily install it using pip, the Python package manager. Run the following command:
-
-```shell
-pip install ansible
-```
+## How to read server info using Terraform
 
-2. Install Scaleway Ansible Collection: Scaleway provides an official Ansible collection that enables you to interact with Scaleway resources, such as creating servers. Install this collection using the `ansible-galaxy` command:
+To read server information after creation, you can use the terraform output command, assuming you have defined output variables in your `resources.tf`. For example:
 
-```shell
-ansible-galaxy collection install scaleway.scaleway
+```terraform
+#resources.tf
+output "server_ip" {
+  value = scaleway_apple_silicon_server.server.ip
+}
 ```
 
-3. Create a directory: Now that you have Ansible and the Scaleway collection installed, create a directory for your Ansible project. This will help you keep everything organized.
-
-    Run the following commands to create and navigate into the project directory:
-    
-    ```shell
-    mkdir apple_silicon_server_ansible
-    cd apple_silicon_server_ansible
-    ```
-
-4. Create a playbook: In Ansible, a playbook is a YAML file that defines the tasks to automate. Create a new file for your playbook named `create_applesilicon_server.yml`:
+After applying the configuration, run:
 
 ```shell
-touch create_applesilicon_server.yml
-```
-
-5. Define the playbook content: Open the `create_applesilicon_server.yml` file in your preferred text editor. Add the following content to define the task of provisioning an Apple silicon server:
-
-```ansible
----
-- name: Create Apple silicon server on Scaleway
-  hosts: localhost
-  gather_facts: no
-  tasks:
-    - name: Create an Apple silicon server
-      scaleway.scaleway.scaleway_applesilicon_server:
-        access_key: "{{ scw_access_key }}"
-        secret_key: "{{ scw_secret_key }}"
-        state: present
-        type_: "M2-M"
-        name: "my-applesilicon-server"
-        zone: "fr-par-1"
-        project_id: "{{scw_project_id}}"
-        vpc_enabled: "false"
-      register: applesilicon_server
+terraform output server_ip
 ```
 
-6. Set up your Scaleway credentials: Replace the placeholders {{ scw_access_key }}, {{ scw_secret_key }}, and {{ scw_project_id }} with your actual credentials. It is a good practice to store these values in environment variables or an Ansible vault for added security. Alternatively, you can use a `.env` file or an external credentials file.
-
-7. Run the playbook: Now that your playbook is ready and your credentials are set, you can run the playbook to create your Apple silicon server.
+## Delve into Terraform with local-exec, remote-exec and null_resource
 
-    Execute the following command:
-    
-    ```shell
-    ansible-playbook create_applesilicon_server.yml
-    ```
-    
-    Ansible will authenticate using your credentials, and the playbook will automatically provision the Apple Silicon server based on the defined parameters.
+In Terraform, provisioners like local-exec, remote-exec, and null_resource can be used to automate the execution of scripts and manage resource configuration. Here’s how you can use them:
 
-8. Check the output: The playbook will output the details of the created server, including its ID, IP address, status, and other relevant information.
+[null_resource](https://registry.terraform.io/providers/hashicorp/null/latest/docs/resources/resource) is a special Terraform resource that doesn’t manage infrastructure directly. It serves as a placeholder for running provisioners and triggers actions without creating any infrastructure.
+[remote-exec](https://developer.hashicorp.com/terraform/language/resources/provisioners/remote-exec) provisioner allows you to execute scripts on remote resources after they’ve been created. It is useful for configuring remote servers or performing post-creation actions.
+[local-exec](https://developer.hashicorp.com/terraform/language/resources/provisioners/local-exec) provisioner enables you to run scripts on your local machine. This is helpful when you need to execute commands in your local environment based on the resources created by Terraform.
 
-With these steps, you have successfully automated the creation of an Apple silicon server on Scaleway using Ansible. You can now extend the playbook to configure your server or automate additional tasks as needed.
+1. We want to connect to our server, so we are going to retrieve all the connection information
 
-## How to read server info using Terraform
-
-To read server information after creation, you can use the terraform output command, assuming you have defined output variables in your `resources.tf`. For example:
+``` terraform
+#resource.tf
 
-```terraform
-#resources.tf
-output "server_ip" {
-  value = scaleway_apple_silicon_server.server.ip
+resource "null_resource" "store_ssh_key" {
+  provisioner "local-exec" {
+    command = <<-EOT
+      mkdir -p ~/.ssh
+      echo "${file("~/.ssh/id_rsa")}" > ~/.ssh/id_rsa
+      chmod 600 ~/.ssh/id_rsa
+      echo 'SSH key stored at ~/.ssh/id_rsa'
+    EOT
+  }
 }
 ```
 
-After applying the configuration, run:
+2. To install dependancies which can be usefull
+
 
-```shell
-terraform output server_ip
-```
 
 ## Conclusion