Skip to content

artubss/SKILLS-CLAUDE-CODE / favorites/tpl-devops-ansible-server-setup

tpl-devops-ansible-server-setup

Unverified

Template do pack (devops/05-ansible-server-setup.md). Orienta o agente em infra, deploy, CI/CD e operacao alinhado a esse contexto.

PROJECT: Ansible Server Setup (Ubuntu 24.04 LTS)

Skill gerado a partir do pack templates-claude-code. Arquivo de origem: devops/05-ansible-server-setup.md. Use como baseline e adapte ao projeto antes de mudancas grandes.

Conteudo do template

STACK

  • Automation: Ansible 9+ (ansible-core 2.16+)
  • Target OS: Ubuntu 24.04 LTS
  • Services: Nginx, Certbot (Let's Encrypt), UFW, Fail2ban, Node.js
  • Secret Management: Ansible Vault
  • Inventory: Static YAML inventory (or dynamic from AWS/GCP)
  • Python: 3.12 (ansible controller), Python 3.12 (managed nodes)

DIRECTORY STRUCTURE

ansible/
├── ansible.cfg
├── inventory/
│   ├── production.yml
│   └── staging.yml
├── group_vars/
│   ├── all.yml                  # Shared vars
│   ├── all/
│   │   └── vault.yml            # Encrypted secrets (ansible-vault)
│   ├── webservers.yml
│   └── appservers.yml
├── host_vars/
│   └── web01.example.com.yml
├── playbooks/
│   ├── site.yml                 # Master playbook
│   ├── setup-server.yml
│   └── deploy-app.yml
└── roles/
    ├── common/
    │   ├── tasks/main.yml
    │   ├── handlers/main.yml
    │   └── vars/main.yml
    ├── nginx/
    │   ├── tasks/main.yml
    │   ├── handlers/main.yml
    │   ├── templates/
    │   │   └── vhost.conf.j2
    │   └── vars/main.yml
    ├── certbot/
    ├── ufw/
    ├── fail2ban/
    └── nodejs/

ARCHITECTURE RULES

  1. Everything is idempotent — run the playbook 10 times; result is the same. Use state: present/absent, never bare shell commands that can double-execute.
  2. Vault for all secrets — no passwords, keys, or tokens in plaintext YAML. Use ansible-vault encrypt_string for inline secrets.
  3. Handlers for service restarts — restart Nginx via notify: restart nginx, not a task. Handlers run only once per play, at the end.
  4. Tags on every task — enables --tags nginx,certbot partial runs.
  5. become: true only when needed — task-level, not play-level wherever possible.
  6. Check mode safe — tasks must support --check --diff without side effects.
  7. Roles are reusable units — no playbook-specific logic inside roles; parameterize via vars/.
  8. Use validate: on config templates — validate: nginx -t -c %s before overwriting live config.

ANSIBLE.CFG

# ansible/ansible.cfg
[defaults]
inventory          = inventory/production.yml
remote_user        = ubuntu
private_key_file   = ~/.ssh/deploy_key
host_key_checking  = True
retry_files_enabled = False
stdout_callback    = yaml
callbacks_enabled  = profile_tasks
gathering          = smart    # Cache facts

[privilege_escalation]
become       = True
become_method = sudo
become_user  = root

[ssh_connection]
pipelining           = True    # Speeds up execution significantly
control_path_dir     = ~/.ansible/cp
ssh_args             = -C -o ControlMaster=auto -o ControlPersist=60s

INVENTORY

# inventory/production.yml
all:
  vars:
    ansible_python_interpreter: /usr/bin/python3

  children:
    webservers:
      hosts:
        web01.example.com:
          ansible_host: 203.0.113.10
        web02.example.com:
          ansible_host: 203.0.113.11
    appservers:
      hosts:
        app01.example.com:
          ansible_host: 203.0.113.20
          node_port: 3000

MASTER PLAYBOOK

# playbooks/site.yml
---
- name: Apply common configuration
  hosts: all
  roles:
    - common
    - ufw
    - fail2ban

- name: Setup web servers
  hosts: webservers
  roles:
    - nginx
    - certbot

- name: Setup app servers
  hosts: appservers
  roles:
    - nodejs

ROLE: COMMON (tasks/main.yml)

---
- name: Update apt cache and upgrade packages
  ansible.builtin.apt:
    update_cache: true
    upgrade: dist
    cache_valid_time: 3600
  tags: [common, packages]

- name: Install required packages
  ansible.builtin.apt:
    name:
      - curl
      - git
      - unzip
      - htop
      - vim
      - logrotate
      - python3-pip
    state: present
  tags: [common, packages]

- name: Set timezone to UTC
  community.general.timezone:
    name: UTC
  tags: [common, timezone]

- name: Ensure deploy user exists
  ansible.builtin.user:
    name: deploy
    groups: sudo
    shell: /bin/bash
    create_home: true
    state: present
  tags: [common, users]

- name: Add SSH authorized key for deploy user
  ansible.posix.authorized_key:
    user: deploy
    key: "{{ vault_deploy_pubkey }}"
    state: present
  tags: [common, users]

- name: Disable root SSH login
  ansible.builtin.lineinfile:
    dest: /etc/ssh/sshd_config
    regexp: "^PermitRootLogin"
    line: "PermitRootLogin no"
    state: present
  notify: restart sshd
  tags: [common, security]

- name: Disable password authentication
  ansible.builtin.lineinfile:
    dest: /etc/ssh/sshd_config
    regexp: "^PasswordAuthentication"
    line: "PasswordAuthentication no"
    state: present
  notify: restart sshd
  tags: [common, security]

ROLE: NGINX (tasks/main.yml)

---
- name: Install Nginx
  ansible.builtin.apt:
    name: nginx
    state: present
  tags: [nginx]

- name: Ensure Nginx is enabled and started
  ansible.builtin.systemd:
    name: nginx
    enabled: true
    state: started
  tags: [nginx]

- name: Remove default Nginx site
  ansible.builtin.file:
    path: /etc/nginx/sites-enabled/default
    state: absent
  notify: reload nginx
  tags: [nginx]

- name: Deploy vhost configuration
  ansible.builtin.template:
    src: vhost.conf.j2
    dest: "/etc/nginx/sites-available/{{ nginx_vhost_name }}.conf"
    owner: root
    group: root
    mode: "0644"
    validate: "nginx -t -c %s"
  notify: reload nginx
  tags: [nginx, vhost]

- name: Enable vhost
  ansible.builtin.file:
    src: "/etc/nginx/sites-available/{{ nginx_vhost_name }}.conf"
    dest: "/etc/nginx/sites-enabled/{{ nginx_vhost_name }}.conf"
    state: link
  notify: reload nginx
  tags: [nginx, vhost]

ROLE: NGINX (handlers/main.yml)

---
- name: reload nginx
  ansible.builtin.systemd:
    name: nginx
    state: reloaded

- name: restart nginx
  ansible.builtin.systemd:
    name: nginx
    state: restarted

- name: restart sshd
  ansible.builtin.systemd:
    name: sshd
    state: restarted

ROLE: UFW (tasks/main.yml)

---
- name: Install UFW
  ansible.builtin.apt:
    name: ufw
    state: present
  tags: [ufw]

- name: Set UFW default policies
  community.general.ufw:
    direction: "{{ item.direction }}"
    policy: "{{ item.policy }}"
  loop:
    - { direction: incoming, policy: deny }
    - { direction: outgoing, policy: allow }
  tags: [ufw]

- name: Allow SSH
  community.general.ufw:
    rule: allow
    port: "22"
    proto: tcp
  tags: [ufw]

- name: Allow HTTP and HTTPS
  community.general.ufw:
    rule: allow
    port: "{{ item }}"
    proto: tcp
  loop: ["80", "443"]
  tags: [ufw]

- name: Enable UFW
  community.general.ufw:
    state: enabled
  tags: [ufw]

ROLE: CERTBOT (tasks/main.yml)

---
- name: Install Certbot and Nginx plugin
  ansible.builtin.apt:
    name:
      - certbot
      - python3-certbot-nginx
    state: present
  tags: [certbot]

- name: Request SSL certificate
  ansible.builtin.command:
    cmd: >
      certbot --nginx
      -d {{ certbot_domain }}
      --non-interactive
      --agree-tos
      --email {{ certbot_email }}
      --redirect
    creates: "/etc/letsencrypt/live/{{ certbot_domain }}/fullchain.pem"
  tags: [certbot]

- name: Ensure renewal timer is enabled
  ansible.builtin.systemd:
    name: certbot.timer
    enabled: true
    state: started
  tags: [certbot]

ROLE: NODE.JS (tasks/main.yml)

---
- name: Download NodeSource setup script
  ansible.builtin.get_url:
    url: https://deb.nodesource.com/setup_20.x
    dest: /tmp/nodesource_setup.sh
    mode: "0755"
  tags: [nodejs]

- name: Run NodeSource setup
  ansible.builtin.command:
    cmd: bash /tmp/nodesource_setup.sh
    creates: /etc/apt/sources.list.d/nodesource.list
  tags: [nodejs]

- name: Install Node.js
  ansible.builtin.apt:
    name: nodejs
    state: present
    update_cache: true
  tags: [nodejs]

- name: Install PM2 globally
  community.general.npm:
    name: pm2
    global: true
    state: present
  tags: [nodejs, pm2]

- name: Configure PM2 startup
  ansible.builtin.command:
    cmd: pm2 startup systemd -u deploy --hp /home/deploy
  changed_when: false
  tags: [nodejs, pm2]

VAULT USAGE

# Create vault-encrypted file
ansible-vault create group_vars/all/vault.yml

# Encrypt an inline value
ansible-vault encrypt_string 'supersecret' --name 'vault_deploy_pubkey'

# Run playbook with vault password file (CI)
echo "$ANSIBLE_VAULT_PASS" > /tmp/vault_pass
ansible-playbook playbooks/site.yml --vault-password-file /tmp/vault_pass
rm /tmp/vault_pass
# group_vars/all/vault.yml (encrypted)
vault_deploy_pubkey: "ssh-ed25519 AAAA..."
vault_db_password: "$(uuidgen)"
vault_jwt_secret: "$(openssl rand -hex 32)"

RUN COMMANDS

# Check syntax
ansible-playbook playbooks/site.yml --syntax-check

# Dry run with diff
ansible-playbook playbooks/site.yml --check --diff

# Run specific tags
ansible-playbook playbooks/site.yml --tags "nginx,certbot"

# Limit to one host
ansible-playbook playbooks/site.yml --limit web01.example.com

# Production run
ansible-playbook playbooks/site.yml --ask-vault-pass
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 318kUpdated Claude CodeCodexUnverifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 117kUpdated Claude CodeCodexUnverifiedInstall